Arthur MCPArthur MCP
Dashboard
How it worksFeaturesDocsEarly accessGitHubDashboard

How to create Architecture Decision Record using MCP

Document architectural decisions with context and consequences. This guide creates the Architecture Decision Record prompt from Arthur's template catalog, sets up a blank MCP server, and links the prompt so any connected AI client can use it.

Steps

  1. Go to Prompt Templates and search for Architecture Decision Record.

    Open the Prompt Templates catalog

    Search the catalog for the Architecture Decision Record template

  2. Click Use template on the Architecture Decision Record card and review the prefilled name, description, and content preview.

    Open the Architecture Decision Record template with its prefilled name and content preview

    Create the Architecture Decision Record prompt in the shared library

  3. Click Create prompt — the prompt is added to your shared library.

    Start creating the MCP server that will expose the prompt

  4. Go to New server, choose Blank / Static as the source, and click Next.

    Choose the Blank / Static source — no external connection is needed for a prompt-only server

    Advance to the server details step

    Name the server after the prompt it will expose

    Create the blank MCP server

    Open the server's Prompts tab

  5. Name the server (for example, Architecture Decision Record Server) and click Create server.

    Open the prompt-library picker

  6. On the server's Prompts tab, click Add prompt, search for Architecture Decision Record, and click Add.

    Search the library for the Architecture Decision Record prompt

    Link the Architecture Decision Record prompt to the server

    Close the picker and show the linked prompt on the Prompts tab

  7. Open the server's Connect section and click Share the MCP swagger documentation — Arthur generates the public documentation link and QR code for this server.

    Open the server's Connect section, where the MCP endpoint and its documentation live

    Open the MCP swagger documentation share panel

    Show the generated swagger documentation link and QR code for this server

Confirm it worked

The Architecture Decision Record prompt appears on the server's Prompts tab, and the Connect section offers the server's MCP swagger documentation — a shareable page with setup instructions for any AI client. A connected client can now fetch the prompt through this server.

Good to know

  • Creates an ADR documenting the context, decision, alternatives considered, and consequences.
  • Arguments detected from the template: {{title}}, {{date}}, {{deciders}} — callers fill these in when invoking the prompt.
  • Editing the prompt in the shared library updates it on every server where it's linked.

Related

Tutorial video