Archboard MCP server
Commit Nov 9, 2026Lets an AI assistant create, read, and edit architecture, flow, and ER diagrams on a live shared canvas.
Also known as getarchboard/archboard-plugin, archboard-plugin
- Stars
- 0
- Tools
- 19
- Downloads, 30 days
- —
- Latest version
- 1.64.0
- Last commit
- Nov 9, 2026
- License
- MIT
What is Archboard MCP?
Archboard lets an AI assistant create, read, and edit architecture, flow, and ER diagrams on a live shared canvas. It exposes 19 tools, such as read_me, list_workspaces, list_diagrams.
Summary generated from the project's README
About Archboard MCP server
Archboard provides a hosted workspace for creating and managing structured diagrams such as architecture, Kubernetes, C4, flowcharts, and ER diagrams. It connects AI assistants to a live shared canvas, allowing them to read, create, and edit diagrams that teams use in real time. Unlike static image generators, this server uses specific node types from various packs to ensure diagrams remain editable and structured for human collaborators.
The server operates remotely via Streamable HTTP and requires OAuth 2.1 authentication through Google or GitHub. It is compatible with many clients including Claude, Cursor, VS Code, and GitHub Copilot CLI. Users can manage diagrams through tools like create_diagram, apply_ops, and compose_diagram. The system also supports visual verification through render_snapshot and allows for exporting files in PNG or SVG formats.
What you can do with it
- 1Generate structured architecture diagramsAsk the assistant to build a complex system diagram including specific services and databases.
- 2Convert existing code to visualsTransform a Mermaid flowchart string into a live, editable diagram on the canvas.
- 3Modify existing diagramsInstruct the AI to add new components or infrastructure elements to a current workspace.
- 4Export diagram assetsRequest a downloadable version of a diagram in a specific file format.
Written from the project's README. Every use case is checked against a quote from it.
How to install Archboard MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Archboard MCP in Claude Code
$ claude mcp add --transport http archboard-plugin https://getarchboard.app/mcpInstall Archboard MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"archboard-plugin": {
"url": "https://getarchboard.app/mcp"
}
}
}Install Archboard MCP in VS Code
.vscode/mcp.json
{
"servers": {
"archboard-plugin": {
"type": "http",
"url": "https://getarchboard.app/mcp"
}
}
}Install Archboard MCP in VS Code CLI
$ code --add-mcp '{"name":"archboard-plugin","type":"http","url":"https://getarchboard.app/mcp"}'Install Archboard MCP in Codex
$ codex mcp add archboard-plugin --url https://getarchboard.app/mcpInstall Archboard MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.archboard-plugin] url = "https://getarchboard.app/mcp"
Install Archboard MCP in Gemini CLI
$ gemini mcp add -s user --transport http archboard-plugin https://getarchboard.app/mcpInstall Archboard MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"archboard-plugin": {
"url": "https://getarchboard.app/mcp",
"type": "http"
}
}
}Archboard MCP tools 19
Detected from the READMEread_melist_workspaceslist_diagramscreate_diagramget_canvassearch_node_typesget_node_typeapply_opscompose_diagramadd_imageupload_imagerender_snapshot
Show all 19 toolsShow fewer tools
export_diagramget_selectionset_statusrevert_changedelete_diagramsearch_shapesshow_diagram
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablegetarchboard/archboard-plugin is public and reachablegithub.com/getarchboard/archboard-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/getarchboard/archboard-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model19 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubArchboard 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.
| App | Install |
|---|---|
| Claude (web, desktop, mobile) | Add custom connector (Customize → Connectors, URL https://getarchboard.app/mcp) |
| Claude Code (plugin with skill) | claude plugin install archboard --marketplace getarchboard/archboard-plugin, then /mcp → plugin:archboard:archboard to sign in |
| Claude and Cowork (plugin with skill) | Customize → Plugins → Add marketplace getarchboard/archboard-plugin, then connect Archboard from the plugin's Connectors tab |
| Claude Code (server only) | claude mcp add --transport http --scope user archboard https://getarchboard.app/mcp, then claude mcp login archboard |
| Cursor | Add to Cursor |
| VS Code | code --add-mcp '{"name":"archboard","type":"http","url":"https://getarchboard.app/mcp"}' |
| Gemini CLI (extension) | gemini extensions install https://github.com/getarchboard/archboard-plugin |
| Antigravity (plugin with skill) | agy plugin install https://github.com/getarchboard/archboard-plugin, then Customizations → Installed → Archboard → MCP → Authenticate |
| Codex (0.147.0 or later) | codex mcp add archboard --url https://getarchboard.app/mcp |
| GitHub Copilot CLI | copilot mcp add --transport http archboard https://getarchboard.app/mcp |
| Grok (web) | grok.com/connectors → New Connector → Custom, URL https://getarchboard.app/mcp |
| Grok Build | grok mcp add --transport http archboard https://getarchboard.app/mcp |
| Kiro | Add to Kiro |
| Other MCP apps | Remote server URL https://getarchboard.app/mcp, transport Streamable HTTP, OAuth sign-in |
Manifests in this repository, by app:
| Path | Used by |
|---|---|
.claude-plugin/plugin.json, .claude-plugin/marketplace.json, .mcp.json |
Claude Code and Claude plugins |
.cursor-plugin/plugin.json, mcp.json |
Cursor |
.antigravity-plugin/plugin.json, mcp.json |
Antigravity |
gemini-extension.json |
Gemini CLI |
chatgpt/ |
ChatGPT and Codex plugin package |
skills/archboard-diagramming/SKILL.md |
Skill: the Archboard diagramming guide |
server.json |
MCP Registry entry |
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
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.Turn this Mermaid flowchart into an Archboard diagram: flowchart LR; Signup --> Verify{Email verified?}; Verify -->|yes| Onboarding; Verify -->|no| ReminderList my Archboard diagrams and summarize the most recently updated one.In the "Checkout service" diagram, add a Redis cache between the orders service and the database, then show me a snapshot.Export the "Checkout service" diagram as an SVG and give me the download link.
Tools
| Tool | What it does | Changes data |
|---|---|---|
read_me |
Usage guide: workflow, document format, layout rules, limits and error codes | No |
list_workspaces |
Organizations and workspaces this connection can use, with role, plan and permission | No |
list_diagrams |
Diagrams this connection can access, newest first, with their permission | No |
create_diagram |
Create a new diagram in a workspace | Yes |
get_canvas |
Read a diagram: an outline, or full records page by page | No |
search_node_types |
Find node types across packs (Kubernetes, cloud, C4, BPMN, mind map and more) | No |
get_node_type |
Size, props, style keys and ports of one node type | No |
apply_ops |
Add, change or remove nodes, connections and images as one revertible change | Yes, can remove |
compose_diagram |
Draw a Mermaid flowchart or an infographic spec as one revertible change | Yes |
add_image |
Add an image from a public https URL; Archboard's server downloads it once | Yes |
upload_image |
One-time upload link for a local image file (apps that can run shell commands) | Yes |
render_snapshot |
PNG render of the diagram or a part of it, for checking the result | No |
export_diagram |
PNG or SVG export with a download link (15 minutes, up to 5 downloads) | No |
get_selection |
What the person has selected in their open editor | No |
set_status |
Short status next to the app's cursor on the canvas | No (presence only) |
revert_change |
Undo one change this app made in the last 7 days | Yes |
delete_diagram |
Move a diagram to the trash (it can be restored; no permanent delete) | Yes, to trash |
search_shapes |
Find built-in and saved shapes and icons by keyword | No |
show_diagram |
Live view of the diagram inside the chat, in apps that support MCP Apps | No |
viewer_poll, viewer_ticket |
Used only by the in-chat viewer; not called by the model | No |
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 togetarchboard.app.export_diagramlinks 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.
Archboard MCP questions
How do I add Archboard MCP to Claude Code?
Run claude mcp add --transport http archboard-plugin https://getarchboard.app/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Archboard MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Archboard MCP provide?
It exposes 19 tools, including read_me, list_workspaces, list_diagrams, create_diagram, get_canvas.
How does the AI interact with my diagrams?
The assistant can read, create, and edit diagrams on the same live canvas your team uses, using structured node types rather than static pictures.
Can I undo changes made by the AI?
Yes, changes made by an app are kept in the diagram's change log and can be undone for up to 7 days.
Does Archboard provide its own AI model?
No, Archboard does not include an AI model; it connects to the assistant provided by the app you have connected.