Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http smithery https://smithery.run.tools
Open on GitHub

What 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-server from the linked GitHub repo and pull the pipeline logs.
  • Add a secret named API_KEY to 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.tools

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

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open