| # 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. | |