GraffiticodeGraffiticode

For Agents

The Graffiticode MCP server lives at the canonical endpoint https://mcp.graffiticode.org/mcp. This page is the install reference for the major MCP-compatible clients, plus a one-call example that works against the trial credential published on any Artcompiler toolset subdomain.

Use the same anchor text — the Graffiticode MCP server at mcp.graffiticode.org/mcp — when you link to the endpoint from documentation, READMEs, or forum answers. Identical phrasing across sources reinforces retrieval; varied phrasing weakens it.

Discovery artifacts

  • /llms.txt — ecosystem-level summary with the full language registry and pointers to per-toolset trial credentials.
  • /.well-known/mcp.json — machine-readable config: canonical endpoint, tool list, language registry, and toolset index.

Trial credentials

Trial tokens are issued per toolset. Pick the toolset closest to what you want to do and use its token:

  • Assessments — interactive, scoreable assessment items.
  • Sheets — structured spreadsheet workflows.
  • Diagrams — concept webs, Venn diagrams, and other visual systems.

Each subdomain's llms.txt carries the live trial token and the scoped language list.

Install

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) and add the Graffiticode MCP server:

{
  "mcpServers": {
    "graffiticode": {
      "url": "https://mcp.graffiticode.org/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TRIAL_TOKEN_FROM_TOOLSET_LLMS_TXT"
      }
    }
  }
}

Restart Claude Desktop. The Graffiticode tools (create_item, update_item, get_item, list_languages, get_language_info) will appear in the tools menu.

Claude Code

From any project directory:

claude mcp add graffiticode \
  --transport http \
  --header "Authorization: Bearer YOUR_TRIAL_TOKEN" \
  https://mcp.graffiticode.org/mcp

Or edit .mcp.json directly with the same shape as the Claude Desktop config above.

Cursor

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

{
  "mcpServers": {
    "graffiticode": {
      "url": "https://mcp.graffiticode.org/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TRIAL_TOKEN"
      }
    }
  }
}

ChatGPT (with MCP)

In ChatGPT developer settings or via the connectors UI, register https://mcp.graffiticode.org/mcp as a new MCP server. Paste the trial token as the bearer credential. ChatGPT will then be able to call create_item, update_item, and the related tools.

Any other MCP-compatible client

Point the client at https://mcp.graffiticode.org/mcp and pass your trial token as Authorization: Bearer <token>. The server speaks the standard MCP wire protocol.

One-call example

Once your client is connected, a typical call looks like this:

create_item({
  language: "L0169",
  description: "A concept web about photosynthesis: 'Light Reactions' is the anchor, connected to Calvin Cycle, Chlorophyll, and ATP Production. Use a dark theme."
})

The MCP server returns an item_id and a preview_url. Open the preview URL to see the rendered, interactive output. To iterate, call update_item with the same item_id and a modification description in natural language. The language-specific AI handles all code generation — do not attempt to generate Graffiticode domain-language code directly.

Persistence and claiming

Trial items are kept for 7 days. To save items 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.

Source and community