Smithery

Smithery is a platform for discovering, deploying, and managing Model Context Protocol (MCP) servers and skills. It operates a public registry of community-built MCP extensions that AI agents can use to access external tools, data sources, and services, plus a Connect gateway that bundles connections in a namespace behind a single MCP endpoint at mcp.smithery.run. The platform exposes APIs for server registry browsing, server deployment, skill publishing, namespace management, scoped service tokens, connection lifecycle, trigger subscriptions, and an MCP transport endpoint for AI-agent integration.

Smithery publishes 9 APIs on the APIs.io network, including connect API, connect.mcp API, domains API, and 6 more. Tagged areas include Artificial Intelligence, Large Language Models, MCP, Model Context Protocol, and AI Agents.

The Smithery catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Smithery’s developer surface includes authentication, documentation, CLI, engineering blog, tooling, and 24 more developer resources.

55.3/100 developing ▬ flat Agent 52/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
9 APIs 2 MCP Servers
Artificial IntelligenceLarge Language ModelsMCPModel Context ProtocolAI AgentsDeveloper ToolsRegistrySkillsTool Discovery

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 55.3/100 · developing
Contract Quality 18.2 / 25
Developer Ergonomics 10.0 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.8 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 52/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/smithery: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

Smithery connect API

The connect API from Smithery — 12 operation(s) for connect.

Smithery connect.mcp API

The connect.mcp API from Smithery — 1 operation(s) for connect.mcp.

Smithery domains API

The domains API from Smithery — 2 operation(s) for domains.

Smithery Health API

The Health API from Smithery — 1 operation(s) for health.

Smithery namespaces API

The namespaces API from Smithery — 3 operation(s) for namespaces.

Smithery organizations API

The organizations API from Smithery — 2 operation(s) for organizations.

Smithery servers API

Browse the MCP server registry, manage server configuration, and handle deployments

Smithery skills API

Discover and search reusable prompt-based skills for MCP servers

Smithery tokens API

The tokens API from Smithery — 1 operation(s) for tokens.

Scroll for all 9

Open Collections 2

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Smithery Platform API

OPEN COLLECTION

Smithery Platform API

OPEN COLLECTION

MCP Servers 2

Model Context Protocol servers that expose these APIs to AI agents.

Smithery MCP Server (mcp.smithery.run)

Hosted MCP gateway endpoint that bundles all connections in a namespace behind a single URL

MCP SERVER

mouseless

Smithery-built tool: Rust MCP server for macOS desktop control

MCP SERVER

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Smithery Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Smithery Context

25 classes · 0 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Smithery API Rules

5 rules · 3 warnings 2 info

SPECTRAL

Smithery API Rules

8 rules · 2 errors 6 warnings

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

Smithery MCP Server

11 properties

JSON SCHEMA

Smithery Skill

8 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Smithery Server Structure

0 properties

JSON STRUCTURE

Examples 7

Example request and response payloads for these APIs.

Scroll for all 7

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Smithery Authentication

http · 1 scheme

SECURITY

Smithery Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Smithery Agentic Access

107 operations · 60 acting · 12 human-in-the-loop

107 operations · 60 acting

AGENTIC

Resources

Documentation 9

Reference material describing how the API behaves

Scroll for all 9

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

Build 10

SDKs, sample code, and the tooling you integrate with

Scroll for all 10

Access & Security 3

Authentication, authorization, and security posture

Company 3

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: smithery
name: Smithery
description: Smithery is a platform for discovering, deploying, and managing Model Context Protocol (MCP) servers and skills.
  It operates a public registry of community-built MCP extensions that AI agents can use to access external tools, data sources,
  and services, plus a Connect gateway that bundles connections in a namespace behind a single MCP endpoint at mcp.smithery.run.
  The platform exposes APIs for server registry browsing, server deployment, skill publishing, namespace management, scoped
  service tokens, connection lifecycle, trigger subscriptions, and an MCP transport endpoint for AI-agent integration.
type: Index
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/smithery.png
tags:
- Artificial Intelligence
- Large Language Models
- MCP
- Model Context Protocol
- AI Agents
- Developer Tools
- Registry
- Skills
- Tool Discovery
created: '2025-08-19'
modified: '2026-05-22'
url: https://raw.githubusercontent.com/api-evangelist/smithery/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: smithery:smithery-connect-api
  name: Smithery connect API
  description: The connect API from Smithery — 12 operation(s) for connect.
  humanURL: https://smithery.ai/docs
  baseURL: https://api.smithery.ai
  tags:
  - connect
  properties:
  - type: OpenAPI
    url: openapi/smithery-connect-api-openapi.yml
  - type: Documentation
    url: https://smithery.ai/docs
  - type: OpenAPI Specification
    url: https://smithery.ai/docs/openapi.json
  - type: OpenAPI Specification
    url: https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml
  - type: LlmsText
    url: https://smithery.ai/docs/llms.txt
  - type: APIReference
    url: https://smithery.ai/docs/api-reference
  - type: JSONSchema
    url: json-schema/smithery-server-schema.json
  - type: JSONSchema
    url: json-schema/smithery-skill-schema.json
  - type: JSONStructure
    url: json-structure/smithery-server-structure.json
  - type: JSONLD
    url: json-ld/smithery-context.jsonld
  - type: SpectralRules
    url: rules/smithery-rules.yml
  - type: Vocabulary
    url: vocabulary/smithery-vocabulary.yml
  - type: Plans
    url: plans/smithery-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/smithery-rate-limits.yml
  - type: FinOps
    url: finops/smithery-finops.yml
- aid: smithery:smithery-connect-mcp-api
  name: Smithery connect.mcp API
  description: The connect.mcp API from Smithery — 1 operation(s) for connect.mcp.
  humanURL: https://smithery.ai/docs
  baseURL: https://api.smithery.ai
  tags:
  - connect.mcp
  properties:
  - type: OpenAPI
    url: openapi/smithery-connect-mcp-api-openapi.yml
  - type: Documentation
    url: https://smithery.ai/docs
  - type: OpenAPI Specification
    url: https://smithery.ai/docs/openapi.json
  - type: OpenAPI Specification
    url: https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml
  - type: LlmsText
    url: https://smithery.ai/docs/llms.txt
  - type: APIReference
    url: https://smithery.ai/docs/api-reference
  - type: JSONSchema
    url: json-schema/smithery-server-schema.json
  - type: JSONSchema
    url: json-schema/smithery-skill-schema.json
  - type: JSONStructure
    url: json-structure/smithery-server-structure.json
  - type: JSONLD
    url: json-ld/smithery-context.jsonld
  - type: SpectralRules
    url: rules/smithery-rules.yml
  - type: Vocabulary
    url: vocabulary/smithery-vocabulary.yml
  - type: Plans
    url: plans/smithery-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/smithery-rate-limits.yml
  - type: FinOps
    url: finops/smithery-finops.yml
- aid: smithery:smithery-domains-api
  name: Smithery domains API
  description: The domains API from Smithery — 2 operation(s) for domains.
  humanURL: https://smithery.ai/docs
  baseURL: https://api.smithery.ai
  tags:
  - domains
  properties:
  - type: OpenAPI
    url: openapi/smithery-domains-api-openapi.yml
  - type: Documentation
    url: https://smithery.ai/docs
  - type: OpenAPI Specification
    url: https://smithery.ai/docs/openapi.json
  - type: OpenAPI Specification
    url: https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml
  - type: LlmsText
    url: https://smithery.ai/docs/llms.txt
  - type: APIReference
    url: https://smithery.ai/docs/api-reference
  - type: JSONSchema
    url: json-schema/smithery-server-schema.json
  - type: JSONSchema
    url: json-schema/smithery-skill-schema.json
  - type: JSONStructure
    url: json-structure/smithery-server-structure.json
  - type: JSONLD
    url: json-ld/smithery-context.jsonld
  - type: SpectralRules
    url: rules/smithery-rules.yml
  - type: Vocabulary
    url: vocabulary/smithery-vocabulary.yml
  - type: Plans
    url: plans/smithery-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/smithery-rate-limits.yml
  - type: FinOps
    url: finops/smithery-finops.yml
- aid: smithery:smithery-health-api
  name: Smithery Health API
  description: The Health API from Smithery — 1 operation(s) for health.
  humanURL: https://smithery.ai/docs
  baseURL: https://api.smithery.ai
  tags:
  - Health
  properties:
  - type: OpenAPI
    url: openapi/smithery-health-api-openapi.yml
  - type: Documentation
    url: https://smithery.ai/docs
  - type: OpenAPI Specification
    url: https://smithery.ai/docs/openapi.json
  - type: OpenAPI Specification
    url: https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml
  - type: LlmsText
    url: https://smithery.ai/docs/llms.txt
  - type: APIReference
    url: https://smithery.ai/docs/api-reference
  - type: JSONSchema
    url: json-schema/smithery-server-schema.json
  - type: JSONSchema
    url: json-schema/smithery-skill-schema.json
  - type: JSONStructure
    url: json-structure/smithery-server-structure.json
  - type: JSONLD
    url: json-ld/smithery-context.jsonld
  - type: SpectralRules
    url: rules/smithery-rules.yml
  - type: Vocabulary
    url: vocabulary/smithery-vocabulary.yml
  - type: Plans
    url: plans/smithery-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/smithery-rate-limits.yml
  - type: FinOps
    url: finops/smithery-finops.yml
- aid: smithery:smithery-namespaces-api
  name: Smithery namespaces API
  description: The namespaces API from Smithery — 3 operation(s) for namespaces.
  humanURL: https://smithery.ai/docs
  baseURL: https://api.smithery.ai
  tags:
  - namespaces
  properties:
  - type: OpenAPI
    url: openapi/smithery-namespaces-api-openapi.yml
  - type: Documentation
    url: https://smithery.ai/docs
  - type: OpenAPI Specification
    url: https://smithery.ai/docs/openapi.json
  - type: OpenAPI Specification
    url: https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml
  - type: LlmsText
    url: https://smithery.ai/docs/llms.txt
  - type: APIReference
    url: https://smithery.ai/docs/api-reference
  - type: JSONSchema
    url: json-schema/smithery-server-schema.json
  - type: JSONSchema
    url: json-schema/smithery-skill-schema.json
  - type: JSONStructure
    url: json-structure/smithery-server-structure.json
  - type: JSONLD
    url: json-ld/smithery-context.jsonld
  - type: SpectralRules
    url: rules/smithery-rules.yml
  - type: Vocabulary
    url: vocabulary/smithery-vocabulary.yml
  - type: Plans
    url: plans/smithery-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/smithery-rate-limits.yml
  - type: FinOps
    url: finops/smithery-finops.yml
- aid: smithery:smithery-organizations-api
  name: Smithery organizations API
  description: The organizations API from Smithery — 2 operation(s) for organizations.
  humanURL: https://smithery.ai/docs
  baseURL: https://api.smithery.ai
  tags:
  - organizations
  properties:
  - type: OpenAPI
    url: openapi/smithery-organizations-api-openapi.yml
  - type: Documentation
    url: https://smithery.ai/docs
  - type: OpenAPI Specification
    url: https://smithery.ai/docs/openapi.json
  - type: OpenAPI Specification
    url: https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml
  - type: LlmsText
    url: https://smithery.ai/docs/llms.txt
  - type: APIReference
    url: https://smithery.ai/docs/api-reference
  - type: JSONSchema
    url: json-schema/smithery-server-schema.json
  - type: JSONSchema
    url: json-schema/smithery-skill-schema.json
  - type: JSONStructure
    url: json-structure/smithery-server-structure.json
  - type: JSONLD
    url: json-ld/smithery-context.jsonld
  - type: SpectralRules
    url: rules/smithery-rules.yml
  - type: Vocabulary
    url: vocabulary/smithery-vocabulary.yml
  - type: Plans
    url: plans/smithery-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/smithery-rate-limits.yml
  - type: FinOps
    url: finops/smithery-finops.yml
- aid: smithery:smithery-servers-api
  name: Smithery servers API
  description: Browse the MCP server registry, manage server configuration, and handle deployments
  humanURL: https://smithery.ai/docs
  baseURL: https://api.smithery.ai
  tags:
  - servers
  properties:
  - type: OpenAPI
    url: openapi/smithery-servers-api-openapi.yml
  - type: Documentation
    url: https://smithery.ai/docs
  - type: OpenAPI Specification
    url: https://smithery.ai/docs/openapi.json
  - type: OpenAPI Specification
    url: https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml
  - type: LlmsText
    url: https://smithery.ai/docs/llms.txt
  - type: APIReference
    url: https://smithery.ai/docs/api-reference
  - type: JSONSchema
    url: json-schema/smithery-server-schema.json
  - type: JSONSchema
    url: json-schema/smithery-skill-schema.json
  - type: JSONStructure
    url: json-structure/smithery-server-structure.json
  - type: JSONLD
    url: json-ld/smithery-context.jsonld
  - type: SpectralRules
    url: rules/smithery-rules.yml
  - type: Vocabulary
    url: vocabulary/smithery-vocabulary.yml
  - type: Plans
    url: plans/smithery-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/smithery-rate-limits.yml
  - type: FinOps
    url: finops/smithery-finops.yml
- aid: smithery:smithery-skills-api
  name: Smithery skills API
  description: Discover and search reusable prompt-based skills for MCP servers
  humanURL: https://smithery.ai/docs
  baseURL: https://api.smithery.ai
  tags:
  - skills
  properties:
  - type: OpenAPI
    url: openapi/smithery-skills-api-openapi.yml
  - type: Documentation
    url: https://smithery.ai/docs
  - type: OpenAPI Specification
    url: https://smithery.ai/docs/openapi.json
  - type: OpenAPI Specification
    url: https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml
  - type: LlmsText
    url: https://smithery.ai/docs/llms.txt
  - type: APIReference
    url: https://smithery.ai/docs/api-reference
  - type: JSONSchema
    url: json-schema/smithery-server-schema.json
  - type: JSONSchema
    url: json-schema/smithery-skill-schema.json
  - type: JSONStructure
    url: json-structure/smithery-server-structure.json
  - type: JSONLD
    url: json-ld/smithery-context.jsonld
  - type: SpectralRules
    url: rules/smithery-rules.yml
  - type: Vocabulary
    url: vocabulary/smithery-vocabulary.yml
  - type: Plans
    url: plans/smithery-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/smithery-rate-limits.yml
  - type: FinOps
    url: finops/smithery-finops.yml
- aid: smithery:smithery-tokens-api
  name: Smithery tokens API
  description: The tokens API from Smithery — 1 operation(s) for tokens.
  humanURL: https://smithery.ai/docs
  baseURL: https://api.smithery.ai
  tags:
  - tokens
  properties:
  - type: OpenAPI
    url: openapi/smithery-tokens-api-openapi.yml
  - type: Documentation
    url: https://smithery.ai/docs
  - type: OpenAPI Specification
    url: https://smithery.ai/docs/openapi.json
  - type: OpenAPI Specification
    url: https://app.stainless.com/api/spec/documented/smithery/openapi.documented.yml
  - type: LlmsText
    url: https://smithery.ai/docs/llms.txt
  - type: APIReference
    url: https://smithery.ai/docs/api-reference
  - type: JSONSchema
    url: json-schema/smithery-server-schema.json
  - type: JSONSchema
    url: json-schema/smithery-skill-schema.json
  - type: JSONStructure
    url: json-structure/smithery-server-structure.json
  - type: JSONLD
    url: json-ld/smithery-context.jsonld
  - type: SpectralRules
    url: rules/smithery-rules.yml
  - type: Vocabulary
    url: vocabulary/smithery-vocabulary.yml
  - type: Plans
    url: plans/smithery-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/smithery-rate-limits.yml
  - type: FinOps
    url: finops/smithery-finops.yml
common:
- type: AgenticAccess
  url: agentic-access/smithery-agentic-access.yml
- type: DomainSecurity
  url: security/smithery-domain-security.yml
- type: Authentication
  url: authentication/smithery-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/smithery-ai
- url: https://github.com/smithery-ai
  name: GitHub Organization
  type: GitHubOrganization
- name: Smithery Documentation
  description: Complete API documentation and developer guides
  url: https://smithery.ai/docs
  type: Documentation
- name: Smithery CLI
  description: Command-line interface for managing MCP servers and skills (npm install -g smithery@latest, Node.js 20+, AGPL-3.0,
    725 stars)
  url: https://smithery.ai/docs/concepts/cli
  type: CLI
- name: Smithery Website
  description: Main platform for discovering and using MCP extensions
  url: https://smithery.ai/
  type: Website
- name: Smithery Playground
  description: Interactive playground for testing MCP servers
  url: https://smithery.ai/playground
  type: Playground
- name: Smithery Blog
  description: Blog covering MCP, AI agents, and platform updates
  url: https://smithery.ai/blog
  type: Blog
- name: Smithery Skills Directory
  description: Browse reusable skills and prompt-based AI capabilities
  url: https://smithery.ai/skills
  type: Documentation
- name: API Keys
  description: Manage API keys for Smithery platform access
  url: https://smithery.ai/account/api-keys
  type: Authentication
- name: TypeScript SDK
  description: '@smithery/api - Server-side TypeScript / JavaScript client (generated by Stainless), full type definitions,
    auto-retry, file upload, auto-pagination, multi-runtime (Node, Deno, Bun, Cloudflare Workers, Vercel Edge)'
  url: https://github.com/smithery-ai/typescript-api
  type: SDKs
- name: Smithery CLI GitHub Repository
  description: Smithery CLI source — Install, manage and develop MCP servers and skills for agents (TypeScript, AGPL-3.0,
    725 stars)
  url: https://github.com/smithery-ai/cli
  type: SDKs
- name: Smithery Cookbook
  description: Collection of recipes showcasing effective ways of using Smithery
  url: https://github.com/smithery-ai/smithery-cookbook
  type: SampleCode
- name: MCP Concepts Documentation
  description: 'Conceptual primer: What is MCP, Namespaces, CLI usage'
  url: https://smithery.ai/docs/concepts/what_is_mcp
  type: Documentation
- name: Connect API — Deep Linking
  description: Deep-link patterns for routing users into a Connect flow
  url: https://smithery.ai/docs/use/deep-linking
  type: Documentation
- name: Connect API — Token Scoping
  description: Documented token scopes for Connect-issued service tokens
  url: https://smithery.ai/docs/use/token-scoping
  type: Documentation
- name: Connect API — Uplink
  description: Uplink lets locally-running MCP servers be exposed through Smithery without a public deployment
  url: https://smithery.ai/docs/use/uplink
  type: Documentation
- name: Connect API — Listing Your Client
  description: How AI-agent clients list themselves on Smithery
  url: https://smithery.ai/docs/use/listing_your_client
  type: Documentation
- name: Build — Publish MCP Server
  description: 'Publishing workflow: URL-based proxying or local MCPB bundles; auto-scan via /.well-known/mcp/server-card.json'
  url: https://smithery.ai/docs/build/publish
  type: Documentation
- name: Build — Triggers
  description: Build server-side triggers that fire connection-scoped events
  url: https://smithery.ai/docs/build/triggers
  type: Documentation
- name: Cookbook — TypeScript OAuth Client
  description: Example for building an OAuth client against Smithery in TypeScript
  url: https://smithery.ai/docs/cookbooks/typescript_oauth_client
  type: SampleCode
- name: Integration — Vercel AI SDK
  description: Integration recipe for using Smithery with the Vercel AI SDK
  url: https://smithery.ai/docs/integrations/vercel_ai_sdk
  type: Integrations
- name: Smithery MCP Server (mcp.smithery.run)
  description: Hosted MCP gateway endpoint that bundles all connections in a namespace behind a single URL
  url: https://mcp.smithery.run
  type: MCPServer
- name: agent.pw
  description: 'Smithery-built tool: Share APIs with agents, without sharing secrets'
  url: https://github.com/smithery-ai/agent.pw
  type: Tools
- name: mouseless
  description: 'Smithery-built tool: Rust MCP server for macOS desktop control'
  url: https://github.com/smithery-ai/mouseless
  type: MCPServer
- name: mcp-to-cli
  description: 'Smithery-built tool: Convert MCP servers to CLI tools'
  url: https://github.com/smithery-ai/mcp-to-cli
  type: Tools
- name: workers-biscuit
  description: 'Smithery-built tool: Biscuit tokens for Cloudflare Workers'
  url: https://github.com/smithery-ai/workers-biscuit
  type: Tools
- name: registry
  description: 'Smithery-built repo: "The fastest way to extend your AI"'
  url: https://github.com/smithery-ai/registry
  type: Tools
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com