Quickstart

Connect your agent in 30 seconds

The Graffiticode MCP server lives at https://mcp.graffiticode.org/mcp. No credential is required to try it — call with no Authorization header and you’re on the free plan. Use the same anchor text — the Graffiticode MCP server at mcp.graffiticode.org/mcp — wherever you link to it.

Free-plan access

No credential is required to try Graffiticode. Call the MCP server with no Authorization header and your work is scoped to your MCP session. Pass a Bearer token only to use your own account (gc_…) or OAuth.

• Your work is scoped to your MCP session (forwarded as X-Free-Plan-Session).
• Unclaimed items are kept for 48 hours.
• A Bearer token is only ever your own account API key (gc_…) or an OAuth token — never required for the free plan.

Install

Claude Desktop

Edit claude_desktop_config.json and add the server, then restart. The tools (list_languages, get_language_info, create_item, update_item, get_item) appear in the tools menu.

{
  "mcpServers": {
    "graffiticode": {
      "url": "https://mcp.graffiticode.org/mcp"
    }
  }
}

Claude Code

claude mcp add graffiticode \
  --transport http \
  https://mcp.graffiticode.org/mcp

Cursor

Edit ~/.cursor/mcp.json (or project-scoped .cursor/mcp.json).

{
  "mcpServers": {
    "graffiticode": {
      "url": "https://mcp.graffiticode.org/mcp"
    }
  }
}

ChatGPT & any other MCP client

Register https://mcp.graffiticode.org/mcp as a new MCP server. Leave the credential blank — the server speaks the standard MCP wire protocol over the free plan.

Your first call

Once connected, a typical call looks like this:

create_item({
  language: "L0166",
  description: "A monthly budget spreadsheet with labeled income and expense rows, a SUM total, and a remaining-balance cell that updates live."
})

The server returns an item_id and a view_url — open it to see the rendered, interactive output. To iterate, call update_item with the same item_id and a natural-language change. The specialized AI handles all code generation — do not attempt to write Graffiticode domain-language code directly.

Persistence & claiming

Free-plan items are kept for 48 hours. To save them permanently, follow the claim_url returned in each create_item response, or sign in at the Graffiticode console. Email sign-in is available — no Ethereum wallet required.