# MCP Blacksmith Docs

## Docs

- [Connecting to AI Agents](https://docs.mcpblacksmith.com/deployment/connecting-agents.md): How to connect your generated MCP server to any MCP-compatible AI client, IDE, or agent framework.
- [Local Development](https://docs.mcpblacksmith.com/deployment/local.md): Run your generated MCP server locally for development and testing.
- [Self-Hosting](https://docs.mcpblacksmith.com/deployment/self-hosting.md): Deploy your generated MCP server with Docker or on any cloud provider.
- [Enhancement](https://docs.mcpblacksmith.com/generation/enhancement-passes.md): Optional optimization passes that improve your generated server for production use.
- [Generation](https://docs.mcpblacksmith.com/generation/generation.md): Configure and run MCP server generation — tools, passes, authentication overrides, and real-time progress tracking.
- [Upload](https://docs.mcpblacksmith.com/generation/spec-upload.md): Supported specification formats and how to upload your OpenAPI specification.
- [Validation](https://docs.mcpblacksmith.com/generation/validation.md): Validate your OpenAPI specification before generation to uncover structural issues and improve server quality.
- [How It Works](https://docs.mcpblacksmith.com/how-it-works.md): Understand the MCP Blacksmith generation pipeline — from OpenAPI specification to running server.
- [Introduction](https://docs.mcpblacksmith.com/index.md): MCP Blacksmith generates production-ready MCP servers from OpenAPI specifications in seconds.
- [Quickstart](https://docs.mcpblacksmith.com/quickstart.md): Generate and run your first MCP server in under 2 minutes.
- [FAQ](https://docs.mcpblacksmith.com/reference/faq.md): Frequently asked questions about MCP Blacksmith.
- [OpenAPI 3.0](https://docs.mcpblacksmith.com/reference/oas-3-0.md): Compliance reference for OpenAPI Specification 3.0.0–3.0.4.
- [OpenAPI 3.1](https://docs.mcpblacksmith.com/reference/oas-3-1.md): Compliance reference for new and changed features in OpenAPI 3.1 (JSON Schema 2020-12 alignment).
- [OpenAPI 3.2](https://docs.mcpblacksmith.com/reference/oas-3-2.md): Compliance reference for new and changed features in OpenAPI Specification 3.2.
- [Troubleshooting](https://docs.mcpblacksmith.com/reference/troubleshooting.md): Common issues and how to resolve them.
- [Authentication](https://docs.mcpblacksmith.com/server/authentication.md): How generated MCP servers handle authentication — OAuth2, API keys, JWT, Bearer tokens, and more.
- [Security Features](https://docs.mcpblacksmith.com/server/security.md): Circuit breakers, rate limiting, retries, timeouts, and validation — built into every generated server.
- [Server Structure](https://docs.mcpblacksmith.com/server/structure.md): What's inside a generated MCP server — file layout, purpose of each file, and how they work together.

## OpenAPI Specs

- [openapi](https://docs.mcpblacksmith.com/api-reference/openapi.json)