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 (search) 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.
render_item — preferred way to retrieve and display a finished item; returns a compact result and renders it inline in Claude.
get_item — retrieve an item’s raw code and data by id (for programmatic clients).
get_spec — get a platform-neutral English description of an item’s content.

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.

Generation takes time, so create_item and update_item return immediately with a status of generating; call render_item to wait for and display the finished result.

An item’s src and data are private to its own language. To reuse one item’s content in another language, call get_spec and pass the spec to create_item — never pass a raw item id or its code across languages.

Resources

Alongside the tools, the server exposes MCP resources:

Language user guides — graffiticode://language/{id}/user-guide, the full authoring reference for a language.
Agent skills — graffiticode://skills/<id>, discovered at request time from the public graffiticode-skills repo, so new skills appear without a redeploy.
Inline widget — in Claude (MCP Apps), items render as interactive widgets directly in the chat. In ChatGPT the result is shown as a text summary with an “Open in Graffiticode” link.

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. Once an item is ready, the response includes a view_url for viewing it 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 Artcompiler and hosted on Google Cloud Run. Source is available under the MIT license at github.com/graffiticode/graffiticode-mcp-server.