User guide · AI assistants
Write and edit charts with ChatGPT, Claude, Gemini and other AI assistants
ChordCast works inside ChatGPT, Claude, Gemini and other AI assistants. Ask for a chart in words, paste a song's chords, or send a photo of a lead sheet: the assistant writes the chart, checks it with the same engine the ChordCast apps draw with, shows you how it looks, and shares it as a setlist your band opens in ChordCast.
What it can do
- Write charts from a description, chords you paste, or a photo or screenshot of a chart. It sees each chart drawn as ChordCast draws it, so it can check its work against yours.
- Make a shared setlist of one or many charts, and give you its links. Open the link in the ChordCast app or a browser.
- Edit a setlist you share with it: fix a chart, add songs, reorder or rename the set. Bandmates see the changes right away, and every chart keeps its earlier versions.
Add ChordCast to your assistant
ChordCast connects with one address, and needs no account or sign-in:
https://chordcast.app/mcp | Assistant | How |
|---|---|
| Claude | Settings → Connectors → Add custom connector, name it ChordCast and paste the address. (Claude's directory listing is on its way.) |
| ChatGPT | Settings → Plugins: look for ChordCast. (Until it's listed, ChatGPT's developer mode can add it by the address.) |
| Gemini | Customize (in the sidebar) → Connectors → + Custom, paste the address and choose Next. |
| Other assistants and coding tools | Any client that supports remote MCP servers (Streamable HTTP): add the address. |
Things to ask
- “Make a ChordCast chart of a 12-bar blues in F with a turnaround, and share it with me.”
- “Here's a photo of our lead sheet. Recreate it in ChordCast.”
- “Make a setlist for Friday: these five songs, with the chords I'm pasting below.”
- “In this setlist, add a two-bar intro to the second song and move the ballad to the end:” followed by the setlist's edit link.
Edit a chart with ChatGPT or Claude from ChordCast
In the web app, a chart's panel has Edit with ChatGPT and Edit with Claude. Each opens a new conversation that already names the chart and carries the setlist's edit link, so the assistant can read the chart and change it with you. Add ChordCast to the assistant first (above); if it isn't added, the assistant tells you how.
The link is the key. A setlist's edit link lets whoever has it edit the setlist, and that includes an assistant you give it to. Give an assistant the view-only link when it only needs to read. If a link went somewhere it shouldn't, use Change a Link… in ChordCast so it stops working. See Share setlists with a link.
For the technically curious
ChordCast's address is a remote MCP server (Streamable HTTP, no authentication). Its tools:
| Tool | Does |
|---|---|
check_chart | Checks a chart and returns it drawn as a PNG, with problems by line and warnings (chords it can't read, bars whose rhythm doesn't add up). Read only. |
create_setlist | Makes a shared setlist of charts and returns its edit and view links. |
read_setlist | Reads a setlist from its link. Read only. |
save_chart | Saves a new version of a song's chart, or adds a song. Refuses to overwrite a bandmate's newer edit. |
arrange_setlist | Reorders, trims or renames a setlist. |
Charts use ChordCast's chart text: see the chart text reference. The server
card is at /.well-known/mcp/server-card.json. What the server keeps is in the
privacy policy.