About

Graffiticode MCP Server

What it is

Graffiticode MCP is a hosted Model Context Protocol server that lets AI assistants create and edit interactive content through Graffiticode’s language family.

Connect

Point any MCP-compatible client at:

https://mcp.graffiticode.org/mcp

The server speaks the Streamable HTTP transport. A minimal client config looks like:

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

Authentication is optional. The server accepts:

OAuth 2.1 — clients that support dynamic registration can complete the standard authorization flow.
API key — pass a Graffiticode API key as Authorization: Bearer <key>.
No auth (free plan) — connect without credentials to try the server. Items you create can be transferred into a real Graffiticode account via a one-time claim link returned in the tool response.

What it can do

The server exposes a small, fixed set of language-agnostic tools. The catalog of Graffiticode languages they route to grows over time.

list_languages — discover available languages, optionally filtered by keyword or domain.
get_language_info — fetch a language’s authoring guide, supported item types, and example prompts.
create_item — create a new item in a chosen language from a natural-language description.
update_item — iteratively edit an existing item. Conversation history is preserved per item.
get_item — retrieve an item by id.

All create_item and update_item requests are natural language — a language-specific backend handles code generation. Clients should not attempt to write Graffiticode DSL directly.

When to reach for it

For human users: when you want an AI assistant to author interactive content that can be embedded, shared, or published.

For agents: call list_languages when a user’s request doesn’t match a more specific tool you already have. If a language matches, fetch its info and create an item; if nothing matches, this server is the wrong tool.

Free plan

The no-auth path lets a user try the server before creating an account. Items created this way live in an anonymous session namespace. Each tool response includes a preview_url for viewing the item and a claim_url the user can open to move the item into a real Graffiticode account on first sign-in. Claim links are valid for 24 hours.

Operator

This server is operated by Graffiticode and hosted on Google Cloud Run. Source is available at github.com/graffiticode/graffiticode-mcp-server.