Archboard

Archboard plugin

Archboard is a hosted diagram workspace for architecture, Kubernetes, C4, flowcharts, ER diagrams, mind maps and boards. This repository connects AI apps to the Archboard MCP server, so an assistant can read, create and edit diagrams on the same live canvas your team uses. Every node has a type from a node pack, so the result stays a structured diagram that people keep editing, not a static picture.

• MCP server: https://getarchboard.app/mcp (remote, Streamable HTTP, OAuth 2.1)
• Docs: getarchboard.app/docs/mcp · setup guides per app: getarchboard.app/integrations
• MCP Registry name: app.getarchboard/archboard

This repository holds configuration files, one skill written in Markdown, and images. It contains no code and runs nothing on your computer.

Install

Each line is one step. The first time a tool is used, the app opens the Archboard sign-in in your browser (see Sign-in and access). If you already added Archboard from your app's connector directory, there is no need to add it again here.

Manifests in this repository, by app:

Sign-in and access

• Sign-in uses OAuth 2.1 (authorization code with PKCE). Apps register with a Client ID Metadata Document or dynamic client registration. People sign in to Archboard with Google or GitHub.
• On the consent screen you choose which organizations and workspaces the app can reach, and whether it may read, edit or delete there. Deleting moves a diagram to the trash, where it can be restored.
• You can change or remove an app's access at any time under Settings → Connected apps in Archboard. Removing it disconnects the app right away.
• The app's cursor on the canvas is labeled with the app's name and the person it acts for.

Example prompts

1. Create a new Archboard diagram called "Checkout service" showing a web app, an API gateway, an orders service, a payments service and a Postgres database, with labeled connections.
2. Turn this Mermaid flowchart into an Archboard diagram: flowchart LR; Signup --> Verify{Email verified?}; Verify -->|yes| Onboarding; Verify -->|no| Reminder
3. List my Archboard diagrams and summarize the most recently updated one.
4. In the "Checkout service" diagram, add a Redis cache between the orders service and the database, then show me a snapshot.
5. Export the "Checkout service" diagram as an SVG and give me the download link.

Tools

Every tool declares a title and read-only, destructive, idempotent and open-world hints. The live list is in the server card.

Limits

• Plan limits are the same as in the Archboard editor. On the Free plan: 3 diagrams, and per diagram 15 diagram nodes plus 150 notes, text, drawings, stickers and mind map topics. Plan details: getarchboard.app/pricing.
• Per diagram: 2,000 nodes and connections, 5 MiB of images, 4 MiB of other content. Per call: 10,000 operations, 6 MiB.
• Tool calls are rate-limited per user and per token. When a limit is reached, the server returns a short message that says which limit applies.

Data and privacy

• Your AI app talks to one server: https://getarchboard.app/mcp. Diagrams, your account and the connections you approve are stored by Archboard. See the privacy policy and the terms.
• Changes an app makes are kept in the diagram's change log so they can be undone for 7 days (revert_change).
• add_image: Archboard's server downloads the https URL you give, once, and stores the image in the diagram.
• upload_image: in apps that can run shell commands, the app runs a one-time upload command that sends the one image file you named to getarchboard.app.
• export_diagram links stop working after 15 minutes or 5 downloads.
• Archboard does not include its own AI model; the assistant is the app you connected.

Support and security

• Support: getarchboard.app/support · hello@getarchboard.app
• Security reports: see SECURITY.md and security.txt.

License

The files in this repository are released under the MIT License. The Archboard service itself is a hosted product governed by its terms.

Archboard is an independent product by Halil Öncen. Names of AI apps in this README describe where the plugin can be installed; this project is not affiliated with or endorsed by their makers.