Adaptive Cards MCP
Generate, validate, and optimize accessible Adaptive Cards for Teams, Outlook, Copilot, and other Microsoft surfaces.
Add to your client
Copy the config for your MCP client and paste it into its config file.
claude mcp add adaptive-cards-mcp -- npx adaptive-cards-mcpPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"adaptive-cards-mcp": {
"command": "npx",
"args": [
"adaptive-cards-mcp"
]
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
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.)
About Adaptive Cards MCP
Adaptive Cards MCP is a TypeScript MCP server that turns natural-language descriptions or structured data into valid, accessible Adaptive Cards v1.6 for Microsoft Teams, Outlook, Web Chat, Windows, Viva Connections, Webex, and generic hosts. Beyond generation, it validates cards (schema + accessibility score + host compatibility), optimizes them, converts data into the best layout (Table/FactSet/List), templatizes static cards into data-bound expressions, and transforms cards across host versions. It ships with MCP prompts for guided multi-step workflows and resources exposing the v1.6 schema, a 7-host compatibility matrix, 36 example cards, and 21 layout patterns. Installable via npx with zero config in Claude Code, GitHub Copilot, Cursor, and Windsurf; also runs as an SSE/HTTP server for Microsoft 365 Copilot / Copilot Studio and ChatGPT connectors.
Tools & capabilities (9)
generate_cardNatural language / data into valid Adaptive Card v1.6 JSON.
validate_cardSchema validation plus accessibility score, host compatibility, and suggested fixes.
data_to_cardAuto-select Table / FactSet / Chart / List based on the shape of the input data.
optimize_cardImprove accessibility, improve performance, and modernize actions.
template_cardConvert a static card into a ${expression} data-bound template.
transform_cardVersion upgrade/downgrade and host-config adaptation across hosts.
suggest_layoutRecommend the best layout pattern for a given description, with rationale.
generate_and_validateGenerate, validate, and optionally optimize a card in one call.
card_workflowMulti-step pipeline: generate, optimize, template, transform.
What this server can do
Adaptive Cards MCP provides tools for these capabilities — tap one to see every MCP server that does the same:
When to use it
- Create approval and workflow cards (expense approval, time-off requests) for Teams with action buttons.
- Generate CI/CD or incident notification cards with status badges and rollback/escalate actions.
- Turn API responses, JSON, or CSV data into Table/FactSet cards automatically.
- Validate existing cards and auto-fix schema and accessibility issues.
- Adapt a card that works in Teams to Outlook (v1.4) or Webex (v1.3) by downgrading unsupported features.
Security notes
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 FAQ
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.
Is there a programmatic library?
Yes. The same package is published to npm as adaptive-cards-mcp and exports functions like generateCard, validateCardFull, dataToCard, and optimizeCard for use in bots, APIs, and CI pipelines.
Alternatives to Adaptive Cards MCP
Compare all alternatives →
Control Blender from Claude and other LLMs for prompt-assisted 3D modeling, scene creation, and asset generation.
Popular community server that feeds Figma layout data to coding agents via a Figma API token.
Generate beautiful, modern UI components from natural-language descriptions inside your IDE.
Compare Adaptive Cards MCP with: