Smithery
Installation
SKILL.md
Smithery Skill Reference
Product summary
Smithery is a managed platform for connecting AI agents to Model Context Protocol (MCP) servers. Instead of implementing MCP protocol directly, handling OAuth flows, and managing credentials yourself, Smithery Connect provides a REST API and SDK that abstracts away authentication, token refresh, and connection lifecycle management. Use Smithery to add tools to LLMs, publish MCP servers for distribution, manage multi-user connections with scoped tokens, and integrate with frameworks like Vercel AI SDK. Key files: @smithery/api (SDK), @smithery/cli (CLI), SMITHERY_API_KEY (environment variable). Primary docs: https://smithery.ai/docs
When to use
Reach for Smithery when:
- Building AI agents that need access to external tools via MCP servers (GitHub, Exa search, Browserbase, etc.)
- You need to handle OAuth flows without managing redirect URIs, client IDs, or token refresh
- Building multi-user applications where different users connect to different MCP servers
- Publishing your own MCP server for distribution and discovery
- Integrating MCP tools with Vercel AI SDK or other LLM frameworks
- You need to scope API tokens for browser/mobile clients with fine-grained permissions
- Managing long-lived connections to MCP servers with automatic credential storage and refresh