Smithery — Claude Code MCP server: what it does, how to install
Remote MCP server for the Smithery registry: find servers and skills, ship releases, manage secrets, namespaces and organization keys.
no license 690 installs updated 2026-04-26
claude mcp add --transport http smithery https://smithery.run.toolsWhat Smithery does
The client talks to https://smithery.run.tools over HTTP, so the tools act on whatever Smithery account is behind the connection. Registry search runs on plain keywords or on meaning through the q parameter. Skills work the same way, narrowed by category, namespace or slug.
The other half of the toolset is about your own listings. Create a server, edit its metadata, push a release as a JS module upload, an external URL or an MCPB bundle for stdio. There is also a GitHub repo link, the run.tools slug, secrets and namespaces. A release that stopped for OAuth can be resumed, including the newest one via id='latest'.
Listing secrets gives you names and nothing else, values stay hidden, so keep the real key in your own vault. Organization keys under organizations.api_keys.* require an admin role; a plain member gets refused. For machine-to-machine calls there is tokens.create, and you can attach restrictions to the token it returns.
What it helps with
- find an MCP server for a task without leaving the editor
- push a release and read its pipeline logs
- store an API key as a server secret
- issue a service token for machine-to-machine calls
- delete a namespace together with its skills
Example prompts for the agent
- Search the Smithery registry for MCP servers that talk to Postgres and show which ones are verified.
- Ship a new release of
my-org/my-serverfrom the linked GitHub repo and pull the pipeline logs. - Add a secret named
API_KEYto that server and don't echo the value back.
How to install Smithery
Platform CLI: remote server
claude mcp add --transport http smithery https://smithery.run.toolsPlatform CLI: remote server
codex mcp add smithery --url https://smithery.run.toolsConfig file
{
"mcpServers": {
"smithery": {
"url": "https://smithery.run.tools"
}
}
}Config file
{
"servers": {
"smithery": {
"type": "http",
"url": "https://smithery.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http smithery https://smithery.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Smithery
How do I install Smithery in Claude Code?
Run claude mcp add --transport http smithery https://smithery.run.tools. The server is remote, so nothing runs on your machine.
What does Smithery do?
It hands the agent tools for the Smithery registry and your account: server and skill search, server creation, releases, secrets, namespaces, tokens and organization API keys.
Do organization API keys need a special role?
Yes, admin. Listing, creating and deleting them under organizations.api_keys.* fails without it, and the key values never come back in the response.