Smithery
Discover, deploy, and manage MCP servers on Smithery.
Community: Submitted by a user or imported; check the owner before granting accessOnlineAPI key requiredGlobalFreeRead-only
What it can do
- Servers.Get: Retrieve server details including connections, tools, and security status.
- Servers.Update: Create a new server. Idempotent — returns success if the server already exists and is owned by the caller.
- Servers.By Qualified Name.Update: Update server metadata such as display name, description, icon, or visibility.
What data it sees
Do you need an account
An API key from the service settings is required
Discover, deploy, and manage MCP servers on Smithery. Browse the registry, manage server deployments, releases, secrets, and team API keys, and run skills.
How to connect
How to connect Smithery to Claude
The server address to paste into Claude settings:
https://smithery.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect Smithery to ChatGPT
The server address to paste into ChatGPT settings:
https://smithery.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect Smithery to Cursor
The server address to paste into Cursor settings:
https://smithery.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (46)
Raw names from tools/list. Only developers need these.
| servers.get | Retrieve server details including connections, tools, and security status. |
| servers.update | Create a new server. Idempotent — returns success if the server already exists and is owned by the caller. |
| servers.by_qualified_name.update | Update server metadata such as display name, description, icon, or visibility. |
| servers.delete | Permanently delete a server, its releases, and associated resources. |
| servers.releases.list | List releases ordered by most recent first. Logs are omitted — fetch a specific release to see logs. |
| servers.releases.update | Submit a release via multipart form. Supports hosted (JS module upload), external (URL), and stdio (MCPB bundle) release types. |
| servers.releases.get | Retrieve release details including status, git metadata, pipeline logs, and MCP endpoint URL. |
| servers.releases.resume | Resume a paused release (e.g. after OAuth authorization). Use id='latest' to resume the most recent one. |
| servers.secrets.list | List secret names. Values are not returned. |
| servers.secrets.update | Create or update a secret value. |
| servers.secrets.delete | Remove a secret by name. |
| servers.repo.get | Get the connected GitHub repository, if one exists. |
| servers.repo.update | Create or update the GitHub repository connection. Idempotent — updates if a connection already exists. |
| servers.repo.by_qualified_name.update | Partially update the GitHub repository connection settings. Only provided fields are updated. |
| servers.repo.delete | Remove the GitHub repository connection. |
| servers.domains.list | List the domains for a server. |
| servers.domains.update | Update the managed run.tools slug for a server. |
| servers.list | Search and browse public MCP servers in the Smithery registry. Supports full-text and semantic search via the `q` parameter, and filtering by deployment status, verification, ownership, and more. |
| skills.list | Search and browse reusable prompt-based skills. Supports full-text and semantic search via the `q` parameter, and filtering by category, namespace, or slug. |
| skills.get | Get a single skill by its namespace and slug. |
| skills.update | Idempotent endpoint to create or update a GitHub-backed skill. Send application/json with `gitUrl`. |
| skills.delete | Delete a skill by namespace and slug. Requires ownership of the namespace. |
| tokens.create | Create a service token for machine-to-machine authentication. Accepts API key or bearer token. Optionally apply restrictions. |
| namespaces.list | When called without query params, returns the authenticated user's namespaces (backwards compatible). When query params are provided, searches public namespaces with pagination. Use ownerId to filter by owner, hasServers/hasSkills to filter by content, q for text search. |
| namespaces.create | Create a new namespace with a server-generated human-readable name, owned by the authenticated user |
| namespaces.update | Create a new namespace owned by the authenticated user or an organization. This endpoint is idempotent - if the namespace already exists and is owned by the user/org, returns success. Pass organizationId in the request body to create an org-owned namespace. |
| namespaces.delete | Delete a namespace owned by the authenticated user. The namespace must not contain any servers. Skills and connections in the namespace will be deleted automatically. |
| organizations.api_keys.list | Returns all API keys belonging to the organization. Requires admin role. Key values are not included in the response. |
| organizations.api_keys.create | Creates an API key owned by the organization. Requires admin role. |
| organizations.api_keys.delete | Deletes an API key belonging to the organization. Requires admin role. |
| connect.subscriptions.by_namespace.list | List namespace-scoped trigger subscriptions for all connections in the namespace. |
| connect.subscriptions.by_namespace.create | Create a namespace-scoped subscription that receives events from every connection in the namespace. |
| connect.subscriptions.by_namespace.delete | Delete a namespace-scoped trigger subscription. |
| connect.triggers.list | List trigger types exposed by a connection. |
| connect.triggers.by_trigger_name.get | Get the schema for a single trigger type. |
| connect.triggers.create | Create a trigger instance for a connection using the trigger's declared params. |
| connect.triggers.get | Get a specific trigger instance for a connection. |
| connect.triggers.delete | Delete a trigger instance and deregister its upstream webhook. |
| connect.subscriptions.list | List trigger subscriptions scoped to a single connection. |
| connect.subscriptions.create | Create a connection-scoped subscription that receives events from one connection. |
| connect.subscriptions.delete | Delete a connection-scoped trigger subscription. |
| connect.by_namespace.get | List all connections in a namespace. Supports filtering by metadata using `metadata.{key}={value}` query params. |
| connect.create | Create a new MCP connection with an auto-generated ID. Requires API key and namespace ownership. |
| connect.get | Get details for a specific connection. Requires service token with connections:read scope. |
| connect.update | Create or update an MCP connection with the given ID. mcpUrl is required when creating a new connection, but optional when updating. Returns 409 if a different mcpUrl is provided, except while the connection is input_required and the new URL keeps the same host and path. |
| connect.delete | Delete a connection and terminate its MCP session. Requires API key and namespace ownership. |