mcp-create-adaptive-cards

Generate Adaptive Card response templates for MCP-based API plugins.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/BrunoAMSilva/my-config --skill mcp-create-adaptive-cards-brunoamsilva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-create-adaptive-cards
Source: https://github.com/BrunoAMSilva/my-config/tree/main/coding/skills/mcp-create-adaptive-cards
Command: npx skills add https://github.com/BrunoAMSilva/my-config --skill mcp-create-adaptive-cards-brunoamsilva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many MCP-based API plugins return structured JSON that is displayed as plain text or lists, making it hard for users to quickly understand and act on results. This Skill provides guidance and templates to convert API responses into Adaptive Cards so Microsoft 365 Copilot can present rich, interactive, and readable visual summaries.

Core Features & Use Cases

  • Static Templates: Define a single static Adaptive Card for functions that always return the same type of item, ensuring consistent display of title, subtitle, and key fields.
  • Dynamic Templates: Support multiple embedded templates selected per item via a template_selector for APIs that return heterogeneous item types.
  • Combined Fallbacks & Responsive Design: Provide static defaults when selectors fail, use binding expressions and formatters for numbers and conditionals, and follow responsive best practices for Teams, Word, and PowerPoint.
  • Developer Workflow: Produce response_semantics configuration for ai-plugin.json, specify data_path and properties, and include testing guidance for common scenarios like budgets, transactions, and project search results.

Quick Start

Generate Adaptive Card templates for the SearchProjects function so Copilot renders project items with title, status, and a View Details action.

Frequently Asked Questions about mcp-create-adaptive-cards

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I render API results as Adaptive Cards in Microsoft 365 Copilot?

You can render API results as Adaptive Cards by adding response_semantics with static or dynamic templates to your ai-plugin.json, enabling Microsoft 365 Copilot to display structured JSON as visual cards.

What is the best way to display heterogeneous API arrays in Copilot plugins?

Displaying heterogeneous API arrays uses dynamic embedded templates selected per item via a template_selector, allowing Microsoft 365 Copilot to render varied item types from a single API response.

Can I use JSONPath selectors to bind data in Adaptive Card templates?

Yes, you can use JSONPath selectors to define data_path and properties within response_semantics, mapping specific API response fields directly into Adaptive Card binding expressions.

How do I add static fallback templates for MCP-based API plugins?

Adding static fallback templates involves defining a single static_template in your response_semantics configuration to ensure consistent display of title and subtitle when dynamic selectors fail.

Does Adaptive Card response formatting work for Microsoft Teams and Word?

Adaptive Card response formatting works across Microsoft 365 Copilot surfaces like Teams, Word, and PowerPoint by following responsive layout best practices for structured API results.

How to configure response_semantics for a SearchProjects API function?

Configuring response_semantics for a SearchProjects function involves specifying data_path, properties, and template_selector in ai-plugin.json so Copilot renders project items with title, status, and actions.