knowledge/api_wizard.md

KB: API Wizard MCP Server

The API Wizard is a specialized agent role designed to automate the lifecycle of API integration within an MCP (Model Context Protocol) environment.

Capabilities

• Schema Analysis: Automatically parses OpenAPI/Swagger specifications.
• Tool Generation: Dynamically creates MCP tool definitions from endpoint descriptions.
• Authentication Handling: Manages headers, tokens, and OAuth2 flows securely.
• Error Mapping: Translates complex API error codes into human-readable debugging hints for the LLM.

Workflow

1. Discovery: Point the Wizard at a URL or JSON schema.
2. Drafting: The Wizard proposes a set of tool definitions (name, description, input schema).
3. Validation: Testing the generated tools against a sandbox environment.
4. Deployment: Exporting the configuration to the mcpServers section of the agent config.