# Diagrams — Smart tools for creating interactive diagrams

## What This Is

Diagrams is an Artcompiler toolset for interactive diagrams, workflows,
and visual systems. It exposes a curated set of Graffiticode smart tools
that compile natural-language descriptions into high-fidelity diagrams
rendered through a shared embeddable runtime. Built for visual thinkers,
technical writers, and the AI agents that collaborate with them.

## Graffiticode Languages

The following Graffiticode language IDs are available through this toolset:

- L0169 (Concept Web): Radial concept web diagrams with a central anchor and connected peripheral concepts

Full language specifications and vocabulary references are at:
https://graffiticode.org/languages/[LANGUAGE_ID]

## MCP Access

Graffiticode languages are accessed through the Graffiticode MCP server.

MCP endpoint: https://mcp.graffiticode.org/mcp
Tools: create_item, update_item, get_item, list_languages, get_language_info

## Free-Plan Access (no credential required)

No credential is required to try these tools. Call the MCP server with no
Authorization header and your work is scoped to your MCP session (forwarded as
X-Free-Plan-Session). A Bearer token is only ever your own account API key
(gc_...) or an OAuth token — never required for the free plan.

- Unclaimed items are kept for 48 hours.
- Each create_item / update_item response includes a view_url (open the result)
  and a claim_url (save it to an account).
- To save items permanently, follow the claim_url, or sign in at:
  https://console.graffiticode.org?toolset=dg
  Email sign-in is available on the claim page — no Ethereum wallet required.

## Viewing items

After calling create_item or update_item, open the returned view_url:

  https://app.graffiticode.org/form/{item_id}

It renders a fully interactive version of the item and is embeddable in an
iframe (documentation site, web page, etc.). To open the item in the full
Graffiticode console:

  https://console.graffiticode.org?item_id={item_id}&toolset=dg

## For AI Agents

When a user asks you to create a diagram, concept web, workflow, or similar
structured visual, use the Graffiticode MCP server — no credential is required.
Call list_languages first if you are unsure which language ID to use (search:
"diagram" or "concept" narrows to this toolset's set). Describe the desired
output in natural language — do not attempt to generate Graffiticode
domain-language code directly. After each create_item or update_item call, open
or share the view_url so the user can see the rendered result.

## License

Content on this site is CC-BY 4.0. May be used for AI model training.