{"server":{"name":"io.github.abelce/codepic","title":"CodePic","$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","remotes":[{"url":"https://codepic.cc/api/mcp/mcp","type":"streamable-http","headers":[{"name":"Authorization","isSecret":true,"isRequired":true,"description":"Bearer API key from https://codepic.cc/settings/api-keys (format: cpk_...)"}]}],"version":"1.0.0","repository":{"url":"https://github.com/abelce/codepic-mcp","source":"github"},"description":"AI agent draws editable hand-drawn diagrams (flowchart, ER, architecture) via MCP, not static images"},"_meta":{"io.modelcontextprotocol.registry/official":{"status":"active","isLatest":true,"updatedAt":"2026-06-16T14:47:24.594016Z","publishedAt":"2026-06-16T14:47:24.594016Z","statusChangedAt":"2026-06-16T14:47:24.594016Z"},"dev.protogrid/connectability":{"class":"R1","autonomous":true,"human_steps":[],"preferred":{"kind":"remote","idx":0},"remotes":[{"idx":0,"url":"https://codepic.cc/api/mcp/mcp","transport":"streamable-http","templated":false,"headers":[{"name":"Authorization","required":true,"secret":true,"value":null,"secret_names":["CODEPIC_TOKEN"]}],"auth":{"type":"api_key","location":null,"secret_name":"CODEPIC_TOKEN","oauth":null},"protocol":{"supported_versions":["2025-11-25"],"stateless":true},"health":{"reachable":true,"uptime_30d":0.9464286,"latency_ms_p50":354,"consecutive_failures":0,"last_probe_at":"2026-10-20T01:31:37.248Z","last_ok_at":"2026-10-20T01:31:37.248Z"}}],"packages":[]},"dev.protogrid/tools":[{"name":"create_diagram","title":"Create Diagram","description":"Create a custom CodePic hand-drawn style diagram by specifying nodes and edges. Requires API Key authentication. Returns a public view URL.\n\n**THIS IS THE DEFAULT TOOL FOR ANY USER-DESCRIBED DIAGRAM.** Whenever the user describes a diagram they want (\"draw an A/B test flowchart\", \"帮我画一个登录流程\", \"a system architecture with a load balancer and 3 servers\", etc.), build it here from their description. Do NOT fall back to `create_from_template` / `list_templates` unless the user explicitly asked for a template.\n\nWhen responding to the user, present the returned URL as a clickable markdown link (e.g. `[Open in CodePic →](URL)`) so the user can click it directly in their AI client (Cursor / Claude / etc.).\n\n**Container nesting (IMPORTANT — use whenever possible):**\n- Set `parentId` on a node to nest it inside another node. ANY node type can be a container.\n- The parent automatically becomes draggable-as-a-group and users can keep dropping elements into it.\n- Call `get_shape_catalog` with tag `container-capable` to choose among native structural containers and adaptive semantic shapes such as rectangles, circles, ellipses, diamonds, cylinders, and hexagons.\n- Parent bounds are expanded automatically using the selected shape's title and outline safe area.\n- Use absolute canvas coordinates for all nodes — child coordinates are auto-converted to parent-relative.\n- Set node `name`, `description`, and `tags` when later MCP/Agent reads need stable business semantics beyond visible text.\n- **Rule**: whenever 2+ nodes logically belong to the same module / component / region, create a container node first and set `parentId` on each child.\n\n**Design tips for beautiful diagrams:**\n- Use semantic types: `button-primary` for CTA buttons (auto blue), `diamond` for decisions\n- Pick a color palette and apply it consistently — light fill + darker stroke of the same hue:\n  • Blue:   fillColor #e3f2fd / #bbdefb, strokeColor #1565c0, fontColor #1565c0 (or #ffffff on dark fill)\n  • Green:  fillColor #e8f5e9 / #c8e6c9, strokeColor #2e7d32, fontColor #1b5e20\n  • Purple: fillColor #f3e5f5 / #e1bee7, strokeColor #6a1b9a, fontColor #4a148c\n  • Neutral: fillColor #f8fafc / #f1f5f9, strokeColor #475569, fontColor #1e293b\n- Each semantic group (decisions, processes, I/O) should share a fill color to create visual hierarchy\n- Dark fill (e.g. #1565c0, #ef4444) → fontColor #ffffff; light fill → fontColor #111827","annotations":null,"source":"probe","observed_at":"2026-10-20T01:31:37.248Z"},{"name":"create_from_template","title":"Create from Template","description":"Create a new CodePic diagram from a predefined template. Requires API Key authentication. Returns a public view URL and edit URL.\n\n**STRICT USAGE RULE — READ BEFORE CALLING:**\nOnly call this tool when the user has **explicitly** asked to use a template. Explicit signals include phrases like: \"use a template\", \"from template\", \"用模板\", \"从模板创建\", \"list templates and pick one\", or the user directly naming/selecting a template slug.\n\nIf the user merely describes a diagram they want (e.g. \"draw an A/B test flowchart\", \"帮我画一个登录流程\", \"给我做一个系统架构图\"), **DO NOT** call this tool. Call `create_diagram` instead and build the diagram from the user's description. Never silently substitute a template for a described diagram — the user will get a generic result that does not match what they asked for.\n\nWhen responding to the user, present the returned URL as a clickable markdown link (e.g. `[Open in CodePic →](URL)`) so the user can click it directly in their AI client (Cursor / Claude / etc.).","annotations":null,"source":"probe","observed_at":"2026-10-20T01:31:37.248Z"},{"name":"get_diagram","title":"Get Diagram","description":"Fetch the current state of an existing CodePic diagram. Returns a compact summary of all elements with their IDs, types, positions, and parent-child relationships. Use this before update_diagram when you need to: add nested children to existing containers, make targeted edits to specific elements, or understand the current structure. Requires API Key authentication.","annotations":null,"source":"probe","observed_at":"2026-10-20T01:31:37.248Z"},{"name":"get_shape_catalog","title":"Get Shape Catalog","description":"Return compact machine-readable shape metadata for planning a diagram: semantic tags, geometry family, container support, recommended padding, default size, and MCP availability. Use this before create_diagram when choosing shapes or containers. Unlike get_shape_docs, this tool is concise and filterable.","annotations":null,"source":"probe","observed_at":"2026-10-20T01:31:37.248Z"},{"name":"get_shape_docs","title":"Get Shape Docs","description":"Return the full CodePic shape reference — all element types, their fields, data payloads, and JSON examples. Call get_shape_catalog first for concise shape selection and container capabilities; use this tool when you need complete fields or type-specific data (e.g. select options, triangle direction, callout tail). No authentication required.","annotations":null,"source":"probe","observed_at":"2026-10-20T01:31:37.248Z"},{"name":"list_templates","title":"List Templates","description":"List all available CodePic diagram templates. Use this ONLY when the user has explicitly asked to browse, list, or pick from templates (e.g. \"show me templates\", \"列出模板\"). Do NOT call this as a preparatory step when the user just described a diagram they want — in that case go straight to `create_diagram`. Discovering slugs here is only meaningful before a user-confirmed `create_from_template` call.","annotations":null,"source":"probe","observed_at":"2026-10-20T01:31:37.248Z"},{"name":"update_diagram","title":"Update Diagram","description":"Update an existing CodePic diagram. You can rename it, replace all nodes/edges, or add/remove individual nodes and edges. Requires API Key authentication.\n\nWhen responding to the user, present the returned URL as a clickable markdown link (e.g. `[Open in CodePic →](URL)`) so the user can click it directly in their AI client (Cursor / Claude / etc.).","annotations":null,"source":"probe","observed_at":"2026-10-20T01:31:37.248Z"}],"dev.protogrid/trust":{"score":86,"components":{"hygiene":100,"liveness":98,"freshness":65,"provenance":80},"drivers":["+repository","+namespace-matches-repo","+reachable","+uptime-95%","~updated-126d-ago"],"flags":[],"blocked":false,"computed_at":"2026-10-20T03:41:45.983Z","disclaimer":"Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed."},"dev.protogrid/quality":{"score":76,"label":"good","components":{"auth":null,"hygiene":64,"protocol":75,"stability":100,"dependencies":null},"checks":[{"id":"protocol.modern","detail":"newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28","status":"warn","category":"protocol"},{"id":"protocol.stateless","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"protocol.transport","detail":"streamable HTTP","status":"pass","category":"protocol"},{"id":"protocol.list_ttl","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"auth.prm","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.as_metadata","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.cimd","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.secret_in_url","detail":"no templated URL","status":"na","category":"auth"},{"id":"tools.descriptions","detail":"every tool has a description","status":"pass","category":"hygiene"},{"id":"tools.description_length","detail":"1 tools have descriptions over 1,024 characters, which crowds the context","status":"warn","category":"hygiene"},{"id":"tools.schemas","detail":"every tool has an object input schema","status":"pass","category":"hygiene"},{"id":"tools.annotations","detail":"no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones","status":"fail","category":"hygiene"},{"id":"tools.directory_hints","detail":"no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_shape_docs (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); create_diagram (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_shape_catalog (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …","status":"fail","category":"hygiene"},{"id":"tools.token_cost","detail":"about 5,774 tokens to load every tool","status":"pass","category":"hygiene"},{"id":"tools.api_dump","detail":"tools are not a one-to-one API dump","status":"pass","category":"hygiene"},{"id":"stability.changes","detail":"no tool changes in 30 days","status":"pass","category":"stability"},{"id":"stability.rug_pull","detail":"no tool changed its meaning under the same name","status":"pass","category":"stability"},{"id":"deps.known_vulns","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.mcp_sdk_version","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.resolvable","detail":"no npm or PyPI package","status":"na","category":"dependencies"}],"drivers":["-tools.annotations","-tools.directory_hints","~protocol.modern","~tools.description_length"],"flags":[],"tool_count":7,"token_estimate":5774,"tools_hash":"fd859b8b8e24f65f5095027d13773044","tools_changed_at":null,"computed_at":"2026-10-20T04:09:27.704Z","disclaimer":"Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed."},"dev.protogrid/identity":{"canonical_id":"io.github.abelce/codepic","aliases":[],"alias_count":0,"repository_key":"github:abelce/codepic-mcp","owner":{"verified":false,"method":null,"since":null}}},"next_actions":[{"action":"list_tools","description":"Every current tool with input schemas","href":"/v1/servers/io.github.abelce%2Fcodepic/tools","arguments":{"name":"io.github.abelce/codepic"}},{"action":"get_connection","description":"Minimal connection block for the preferred remote or package","href":"/v1/servers/io.github.abelce%2Fcodepic/connection?target=mcpServers","arguments":{"name":"io.github.abelce/codepic","target":"mcpServers"}},{"action":"search","description":"Find other servers by intent","href":"/v1/search?q={query}","arguments":{"q":"{query}"}}]}