MCP Directory

How to add Adaptive Cards MCP to Claude Desktop

Generate, validate, and optimize accessible Adaptive Cards for Teams, Outlook, Copilot, and other Microsoft surfaces. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 27★ · stdio · no auth

Claude Desktop config for Adaptive Cards MCP

claude mcp add adaptive-cards-mcp -- npx adaptive-cards-mcp
{
  "mcpServers": {
    "adaptive-cards-mcp": {
      "command": "npx",
      "args": [
        "adaptive-cards-mcp"
      ]
    }
  }
}

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Adaptive Cards MCP config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Adaptive Cards MCP's tools appear under the 🔌 tools menu.

Before you start

  • Node.js with npx available (the server is fetched and run via npx; no separate install required)
  • An MCP-compatible client (Claude Code, GitHub Copilot, Cursor, Windsurf, etc.)

What Adaptive Cards MCP can do in Claude Desktop

generate_card

Natural language / data into valid Adaptive Card v1.6 JSON.

validate_card

Schema validation plus accessibility score, host compatibility, and suggested fixes.

data_to_card

Auto-select Table / FactSet / Chart / List based on the shape of the input data.

optimize_card

Improve accessibility, improve performance, and modernize actions.

template_card

Convert a static card into a ${expression} data-bound template.

transform_card

Version upgrade/downgrade and host-config adaptation across hosts.

suggest_layout

Recommend the best layout pattern for a given description, with rationale.

generate_and_validate

Generate, validate, and optionally optimize a card in one call.

Security

No API key needed when used via an MCP client — the host LLM provides the intelligence. Telemetry is opt-in and disabled by default (set MCP_TELEMETRY=true to enable); card content, prompts, data payloads, IPs, file paths, and env vars are never sent. For SSE/HTTP transport you can enable auth with MCP_API_KEY (and MCP_AUTH_MODE=bearer).

Adaptive Cards MCP + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Adaptive Cards MCP config there under the "mcpServers" key and restart the client.

Is Adaptive Cards MCP safe to use with Claude Desktop?

No API key needed when used via an MCP client — the host LLM provides the intelligence. Telemetry is opt-in and disabled by default (set MCP_TELEMETRY=true to enable); card content, prompts, data payloads, IPs, file paths, and env vars are never sent. For SSE/HTTP transport you can enable auth with MCP_API_KEY (and MCP_AUTH_MODE=bearer).

Do I need an API key?

No. When used via an MCP client (Claude Code, Copilot, Cursor, Windsurf), the host LLM provides the intelligence. API keys (Anthropic/OpenAI/Azure/Ollama) are only needed for standalone or library usage.

Which Microsoft hosts are supported?

Generic (1.6), Teams (1.6), Outlook (1.4), Web Chat (1.6), Windows (1.6), Viva Connections (1.4), and Webex (1.3). The server downgrades cards to each host's max version and removes unsupported features.

Can it run as an HTTP/SSE server?

Yes. Set TRANSPORT=sse PORT=3001 to run it over SSE/HTTP (e.g., for Microsoft 365 Copilot / Copilot Studio or ChatGPT connectors), optionally with MCP_API_KEY for auth.

View repo Full Adaptive Cards MCP page