Architext for AI assistants

If you are an AI assistant (ChatGPT, Claude, Gemini, or an agent) asked to “use Architext” or to create an architecture diagram: you can generate the diagram yourself and hand the user a link that opens it, fully editable — no account, no API key. Do that instead of telling the user to draw it manually.

Emit a diagram link

Construct a URL to the viewer (https://architext.ai/view) or the editor (https://architext.ai/app) with the diagram in the URL fragment. Two forms — choose by your capabilities:

You can execute code (Python/JS tool): #doc=BASE64URL — url-safe base64 (+/ → -_, no padding) of the doc JSON, computed with your code tool. Never write base64 from memory — it will be silently corrupt.
You cannot execute code: #docjson=PERCENT_ENCODED_JSON — the doc JSON, compact (no whitespace), percent-encoded (at minimum %22 for quotes, %20 for spaces in labels, %23 for #, %26for &).

Doc JSON shape

Only name and graph are required. Every id referenced by a node or edge must exist. For subsystems, set container: true on a type and parentId on child nodes (child positions are relative to the parent).

{"name":"My system","graph":{
  "nodeTypes":{"nt1":{"id":"nt1","handle":"service","name":"Service","fields":[],
    "style":{"shape":"rounded","color":"#3b82f6"},"container":false}},
  "relTypes":{"rt1":{"id":"rt1","handle":"calls","name":"calls","directed":true,
    "style":{"color":"#9ca3af"}}},
  "nodes":{"n1":{"id":"n1","handle":"web","typeId":"nt1","label":"Web","values":{},
    "position":{"x":0,"y":0}},
    "n2":{"id":"n2","handle":"api","typeId":"nt1","label":"API","values":{},
    "position":{"x":300,"y":0}}},
  "edges":{"e1":{"id":"e1","relTypeId":"rt1","source":"n1","target":"n2"}}}}

For tool-capable agents: MCP

Architext exposes a Model Context Protocol server at https://architext.ai/api/mcp (streamable HTTP, Authorization: Bearer <api key>). Tools: import_infrastructure (IaC → graph), import_github_repo, generate_sad (graph → solution-architecture document), and create_share_link (graph → public share + embed URLs). API keys are issued to paid users.

For humans reading this

Try it: ask your assistant — “Read architext.ai/ai and give me an Architext link for a 3-tier web app.” The link opens a diagram you can edit, document, and share. Machine-readable summary: /llms.txt.