# Smithery Documentation

## Docs

- [Call tool](https://smithery.ai/docs/api-reference/connect/call-tool.md): Invoke a tool with JSON arguments.
- [Create connection](https://smithery.ai/docs/api-reference/connect/create-connection.md): Create a new MCP connection with an auto-generated ID. Requires API key and namespace ownership.
- [Create or update connection](https://smithery.ai/docs/api-reference/connect/create-or-update-connection.md): Create or update an MCP connection with the given ID. `server` is the Smithery registry qualified name; `mcpUrl` is for custom MCP URLs. One of them is required when creating a new HTTP connection, but optional when updating. Returns 409 if a different target URL is provided, except while the connec…
- [Delete connection](https://smithery.ai/docs/api-reference/connect/delete-connection.md): Delete a connection and terminate its MCP session. Requires API key and namespace ownership.
- [Get connection](https://smithery.ai/docs/api-reference/connect/get-connection.md): Get details for a specific connection. Requires service token with connections:read scope.
- [Get tool](https://smithery.ai/docs/api-reference/connect/get-tool.md): Get one tool or list tools under a slash-separated category.
- [Get trigger](https://smithery.ai/docs/api-reference/connect/get-trigger.md): Get the schema for a single trigger type.
- [List connections](https://smithery.ai/docs/api-reference/connect/list-connections.md): List all connections in a namespace. Supports filtering by metadata using `metadata.{key}={value}` query params.
- [List tools](https://smithery.ai/docs/api-reference/connect/list-tools.md): List tools exposed by a connection.
- [List tools across a namespace](https://smithery.ai/docs/api-reference/connect/list-tools-across-a-namespace.md): List tools for every connection in a namespace in one response. Each connection is wrapped in an envelope so a failure on one upstream doesn't fail the request. Skips connections in `auth_required`/`input_required` states without calling the upstream.
- [List triggers](https://smithery.ai/docs/api-reference/connect/list-triggers.md): List trigger types exposed by a connection.
- [Subscribe to trigger](https://smithery.ai/docs/api-reference/connect/subscribe-to-trigger.md): Subscribe to (or refresh) a trigger. Supplying the same (params, delivery.url) refreshes the TTL and may rotate the secret.
- [Unsubscribe from trigger](https://smithery.ai/docs/api-reference/connect/unsubscribe-from-trigger.md): Unsubscribe by subscription key (params + delivery.url). Eager teardown — subscriptions also expire naturally on TTL.
- [Health check](https://smithery.ai/docs/api-reference/health-check.md): Check if the service is running
- [Create a new namespace](https://smithery.ai/docs/api-reference/namespaces/create-a-new-namespace.md): 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.
- [Create a new namespace with generated name](https://smithery.ai/docs/api-reference/namespaces/create-a-new-namespace-with-generated-name.md): Create a new namespace with a server-generated human-readable name, owned by the authenticated user
- [Create a server under a namespace (deprecated)](https://smithery.ai/docs/api-reference/namespaces/create-a-server-under-a-namespace-deprecated.md): **Deprecated:** Use PUT /servers/{namespace}/{server} instead. Create a new server under the specified namespace. This endpoint is idempotent.
- [Delete a namespace](https://smithery.ai/docs/api-reference/namespaces/delete-a-namespace.md): 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.
- [Get user's namespaces or search namespaces](https://smithery.ai/docs/api-reference/namespaces/get-users-namespaces-or-search-namespaces.md): 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.
- [Create a team API key](https://smithery.ai/docs/api-reference/organizations/create-a-team-api-key.md): Creates an API key owned by the organization. Requires admin role.
- [List team API keys](https://smithery.ai/docs/api-reference/organizations/list-team-api-keys.md): Returns all API keys belonging to the organization. Requires admin role. Key values are not included in the response.
- [Revoke a team API key](https://smithery.ai/docs/api-reference/organizations/revoke-a-team-api-key.md): Deletes an API key belonging to the organization. Requires admin role.
- [Create a server](https://smithery.ai/docs/api-reference/servers/create-a-server.md): Create a new server. Idempotent — returns success if the server already exists and is owned by the caller.
- [Delete a server](https://smithery.ai/docs/api-reference/servers/delete-a-server.md): Permanently delete a server, its releases, and associated resources.
- [Delete server icon](https://smithery.ai/docs/api-reference/servers/delete-server-icon.md): Remove the server's icon.
- [Download server bundle](https://smithery.ai/docs/api-reference/servers/download-server-bundle.md): Download the MCPB bundle for the latest successful stdio release.
- [Get a release](https://smithery.ai/docs/api-reference/servers/get-a-release.md): Retrieve release details including status, git metadata, pipeline logs, and MCP endpoint URL.
- [Get a server](https://smithery.ai/docs/api-reference/servers/get-a-server.md): Retrieve server details including connections, tools, and security status.
- [Get server icon](https://smithery.ai/docs/api-reference/servers/get-server-icon.md): Retrieve the server's icon image. Returns the image directly with appropriate content type.
- [Infer a tool output schema](https://smithery.ai/docs/api-reference/servers/infer-a-tool-output-schema.md): Infer a best-effort Zod schema from recent successful Tinybird tool outputs. All discovered object fields are marked optional.
- [List all servers](https://smithery.ai/docs/api-reference/servers/list-all-servers.md): 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.
- [List releases](https://smithery.ai/docs/api-reference/servers/list-releases.md): List releases ordered by most recent first. Logs are omitted — fetch a specific release to see logs.
- [List runtime logs](https://smithery.ai/docs/api-reference/servers/list-runtime-logs.md): Fetch recent runtime logs grouped by invocation.
- [Publish a server](https://smithery.ai/docs/api-reference/servers/publish-a-server.md): Submit a release via multipart form. Supports hosted (JS module upload), external (URL), and stdio (MCPB bundle) release types.
- [Resume a release](https://smithery.ai/docs/api-reference/servers/resume-a-release.md): Resume a paused release (e.g. after OAuth authorization). Use id='latest' to resume the most recent one.
- [Stream release logs](https://smithery.ai/docs/api-reference/servers/stream-release-logs.md): Real-time SSE stream of release logs and status updates.
- [Transfer a server](https://smithery.ai/docs/api-reference/servers/transfer-a-server.md): Move a server to another namespace. The caller must have server write access to both the source namespace and the destination namespace.
- [Update a server](https://smithery.ai/docs/api-reference/servers/update-a-server.md): Update server metadata such as display name, description, repository, icon, or visibility.
- [Upload server icon](https://smithery.ai/docs/api-reference/servers/upload-server-icon.md): Upload or replace the server icon. Accepts a single image file via multipart/form-data. Max 1MB. Supported formats: PNG, JPEG, GIF, SVG, WebP.
- [Create a new skill (deprecated)](https://smithery.ai/docs/api-reference/skills/create-a-new-skill-deprecated.md): **Deprecated:** Use PUT /skills/{namespace}/{slug} instead. Create a new skill by linking a GitHub repository containing a SKILL.md file.
- [Create or update a skill](https://smithery.ai/docs/api-reference/skills/create-or-update-a-skill.md): Idempotent endpoint to create or update a GitHub-backed skill. Send application/json with `gitUrl`.
- [Delete a skill](https://smithery.ai/docs/api-reference/skills/delete-a-skill.md): Delete a skill by namespace and slug. Requires ownership of the namespace.
- [Get a skill](https://smithery.ai/docs/api-reference/skills/get-a-skill.md): Get a single skill by its namespace and slug.
- [List or search skills](https://smithery.ai/docs/api-reference/skills/list-or-search-skills.md): Search and browse reusable prompt-based skills. Supports full-text and semantic search via the `q` parameter, and filtering by category, namespace, or slug.
- [Create a service token](https://smithery.ai/docs/api-reference/tokens/create-a-service-token.md): Create a service token for machine-to-machine authentication. Accepts API key or bearer token. Optionally apply restrictions.
- [Overview](https://smithery.ai/docs/build/index.md): Publish your MCP servers on Smithery for distribution and analytics.
- [Publish](https://smithery.ai/docs/build/publish.md): Publish your MCP server on Smithery for distribution and analytics.
- [Triggers](https://smithery.ai/docs/build/triggers.md): Expose events from your MCP server so consumers can receive them as webhooks.
- [Smithery CLI](https://smithery.ai/docs/concepts/cli.md): Use the Smithery CLI to search, connect, and manage MCP servers and skills from the command line.
- [Namespaces](https://smithery.ai/docs/concepts/namespaces.md): Namespaces group your servers, connections, and skills under a shared identifier.
- [What is MCP?](https://smithery.ai/docs/concepts/what_is_mcp.md): What is MCP? How does it work? What does Smithery do with MCP?
- [Build an OAuth-compatible client](https://smithery.ai/docs/cookbooks/typescript_oauth_client.md): How to build an OAuth client in Typescript using Next.js
- [Introduction](https://smithery.ai/docs/index.md): Smithery gives agents more agency by connecting them to the outside world — search the web, query databases, control browsers, reach into business tools, and much more.
- [Vercel AI SDK Integration](https://smithery.ai/docs/integrations/vercel_ai_sdk.md): Integrate MCP servers with Vercel AI SDK using Smithery
- [Connect to MCPs](https://smithery.ai/docs/use/connect.md): Manage MCP connections with a simple REST API - OAuth, tokens, and sessions handled for you.
- [Deep Linking](https://smithery.ai/docs/use/deep-linking.md): Deep links provide a seamless way to integrate Smithery MCPs into supported clients.
- [Listing Your Client](https://smithery.ai/docs/use/listing_your_client.md): Get your MCP client listed on Smithery for easy discovery and installation by end users
- [Token Scoping](https://smithery.ai/docs/use/token-scoping.md): Control which connections and operations a token can access — by user, workspace, or any custom dimension.
- [Uplink](https://smithery.ai/docs/use/uplink.md): Expose a local MCP server as a Smithery connection without deploying it.

## OpenAPI Specs

- [openapi.documented](https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml)
- [openapi](https://smithery.ai/docs/openapi.json)