mcpField
A
azure-api-center

azure-api-center

github.com/microsoftdocsDevelopment796179 installsUpdated 3d ago
Repository

About azure-api-center

An agent skill for Azure API Center, covering API governance, security, configuration, integrations, and deployment. It combines local quick-reference material with remote documentation retrieval for teams managing API inventories and automating governance workflows.

Key features

  1. 01API style checks and governance
  2. 02Authorization schemes and portal access
  3. 03Metadata and instance configuration
  4. 04API inventory sync and notifications
  5. 05Deployment and registration automation

Use cases

  1. 01Apply style checks to APIs
  2. 02Configure API authorization and portal access
  3. 03Sync APIs from API Management
  4. 04Automate API registration and notifications

MCP support

The skill can retrieve documentation with mcp_microsoftdocs:microsoft_docs_fetch, with fetch_webpage as a fallback.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-api-center

After installing, type/azure-api-centerin Claude Code to confirm it loaded.

Details

From the project README

Azure Api Center Skill

This skill provides expert guidance for Azure Api Center. Covers best practices, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
Best PracticesL33-L38Best practices for API governance in API Center: using managed linting for style compliance and applying shift-left checks via the VS Code extension.
SecurityL39-L44Configuring API auth schemes (keys, OAuth, etc.) in API Center and managing portal access/permissions via the VS Code extension
ConfigurationL45-L55Configuring and deploying Azure API Center: backup/restore, plugin marketplace endpoints, ARM/Bicep/CLI provisioning, and defining/customizing governance metadata schemas.
Integrations & Coding PatternsL56-L62Patterns and scripts for syncing APIs between API Center and platforms like API Management, Amazon API Gateway, and Copilot Studio, plus automation via Azure CLI and Logic Apps/Teams
DeploymentL63-L67Automating API linting and registration to Azure API Center (e.g., via GitHub Actions) and instructions for self-hosting the Azure API Center portal.
Best Practices
TopicURL
Use managed linting to enforce API style compliance in Azure API Centerhttps://learn.microsoft.com/en-us/azure/api-center/enable-managed-api-analysis-linting
Apply shift-left API governance with VS Code extensionhttps://learn.microsoft.com/en-us/azure/api-center/govern-apis-vscode-extension
Security
TopicURL
Configure API authorization schemes in Azure API Centerhttps://learn.microsoft.com/en-us/azure/api-center/authorize-api-access
Control API Center portal access via VS Code extensionhttps://learn.microsoft.com/en-us/azure/api-center/enable-api-center-portal-vs-code-extension
Configuration
TopicURL
Configure backup and restore for Azure API Centerhttps://learn.microsoft.com/en-us/azure/api-center/backup-restore
Configure Azure API Center plugin marketplace endpointhttps://learn.microsoft.com/en-us/azure/api-center/enable-api-center-plugin-marketplace
Configure metadata schema for Azure API Center governancehttps://learn.microsoft.com/en-us/azure/api-center/metadata
Create Azure API Center via ARM templatehttps://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-arm-template
Provision Azure API Center using Azure CLIhttps://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-azure-cli
Deploy Azure API Center with Bicep templateshttps://learn.microsoft.com/en-us/azure/api-center/set-up-api-center-bicep
Define custom metadata schema in Azure API Centerhttps://learn.microsoft.com/en-us/azure/api-center/tutorials/add-metadata-properties
Integrations & Coding Patterns
TopicURL
Import Azure API Management APIs into API Centerhttps://learn.microsoft.com/en-us/azure/api-center/import-api-management-apis
Script API Center inventory management with Azure CLIhttps://learn.microsoft.com/en-us/azure/api-center/manage-apis-azure-cli
Automate API registration notifications with Logic Apps and Teamshttps://learn.microsoft.com/en-us/azure/api-center/set-up-notification-workflow
Deployment
TopicURL
Automate API linting deployment in Azure API Centerhttps://learn.microsoft.com/en-us/azure/api-center/enable-api-analysis-linting
Automate API registration to API Center with GitHub Actionshttps://learn.microsoft.com/en-us/azure/api-center/register-apis-github-actions

Comments

Markdown supported