# 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

REST/OpenAPI: https://api.graffiticode.org/openapi.json
Note: the trial token below authenticates the MCP endpoint only. REST/OpenAPI
requires a full account API key — sign in at console.graffiticode.org to obtain
one.

## Trial Access

A trial credential is provided for immediate use without account creation.
Include this token in MCP requests as the Authorization header:

  Bearer 

Trial limits:
- 20 compiles per session per 24 hours
- Unclaimed session items are deleted after 7 days
- Languages restricted to those listed above

To save items permanently, follow the claim_url returned in each
create_item response, or sign in at:
https://console.graffiticode.org?toolset=dg
Email sign-in is available on the claim page — no Ethereum wallet required.

## Item Preview

After calling create_item or update_item, present the result to the user as
a preview URL:

  https://preview.graffiticode.org/items/[ITEM_ID]

Open this URL in a browser tab where possible, or present it as a clickable
link. The user will see a fully rendered, interactive version of the item.
The preview URL is valid for 7 days (unclaimed session account TTL) and is
shareable. To save permanently, follow the claim_url.

To load the item in the full Graffiticode console for further editing:

  https://console.graffiticode.org?item_id=[ITEM_ID]&toolset=dg

To embed the item in a documentation site or web page (iframe), use the
language ID digits (drop the "L" prefix):

  https://l[LANGUAGE_DIGITS].graffiticode.org/form?id=[ITEM_ID]

## For AI Agents

When a user asks you to create a diagram, concept web, workflow, or
similar structured visual, use the Graffiticode MCP server with the trial
token above. 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 preview 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.