Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP port for SSE transport | 3001 |
| DEBUG | No | Enable debug logging: adaptive-cards-mcp | |
| TRANSPORT | No | Transport mode: stdio or sse | stdio |
| MCP_API_KEY | No | API key for HTTP auth | |
| MCP_AUTH_MODE | No | Auth mode: bearer for token validation | |
| MCP_TELEMETRY | No | Enable metrics collection: true | false |
| MCP_RATE_LIMIT | No | Enable rate limiting: true | false |
| OPENAI_API_KEY | No | OpenAI API key (optional for MCP usage as host LLM provides intelligence) | |
| OLLAMA_BASE_URL | No | Ollama local model URL | |
| ANTHROPIC_API_KEY | No | Anthropic Claude API key (optional for MCP usage as host LLM provides intelligence) | |
| AZURE_OPENAI_API_KEY | No | Azure OpenAI API key | |
| AZURE_OPENAI_ENDPOINT | No | Azure OpenAI endpoint URL |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_card | Convert any content — natural language description, structured data, or a combination — into a valid Adaptive Card v1.6 JSON. Returns cardId for reference in subsequent tool calls. |
| validate_card | Validate an Adaptive Card JSON against the v1.6 schema. Returns diagnostics with suggested fixes for each error. Accepts card JSON or a cardId from a previous tool call. |
| data_to_card | Convert structured data (JSON array, CSV, key-value object) into the optimal Adaptive Card presentation. |
| optimize_card | Optimize an existing Adaptive Card. Accepts card JSON or a cardId. |
| template_card | Convert a static Adaptive Card into an Adaptive Card Template with ${expression} data binding. |
| transform_card | Transform an Adaptive Card: upgrade/downgrade version, apply host-specific constraints, or flatten nesting. |
| suggest_layout | Recommend the best Adaptive Card layout pattern for a given description. |
| generate_and_validate | Generate an Adaptive Card and immediately validate + optionally optimize it in a single call. Reduces tool-call overhead for common workflows. |
| card_workflow | Execute a multi-step card pipeline in a single call. Steps: generate, validate, optimize, template, transform. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| create-adaptive-card | Guided workflow to create an Adaptive Card from a description |
| review-adaptive-card | Review an Adaptive Card for accessibility, compatibility, and best practices |
| convert-data-to-card | Convert structured data into the best Adaptive Card presentation |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Adaptive Cards v1.6 Schema | Complete JSON Schema for Adaptive Cards v1.6 |
| Host Compatibility Matrix | Supported versions, elements, actions, and constraints for all hosts |
| Example Cards Catalog | 36 curated example Adaptive Cards |
| Layout Pattern Guide | 21 canonical layout patterns with templates |
| Session Card Store | List of cards stored in the current session (by cardId) |