Namespaces

A namespace is a container for organizing your resources on Smithery. Every server, connection, and skill you create belongs to a namespace. Namespaces appear in URLs and qualified names. For example, a server published under the acme namespace with the slug weather is accessible at smithery.ai/server/acme/weather.

What belongs to a namespace?

Resource	Description
Servers	MCP servers you publish to the Smithery registry
Connections	Managed MCP connections with OAuth and credential storage
Skills	Reusable AI skills that reference MCP servers

Creating a namespace

You can create namespaces via the Namespaces API:

CLI
TypeScript
cURL

smithery namespace create my-namespace

import Smithery from '@smithery/api'

const smithery = new Smithery()

// Specific name
await smithery.namespaces.set('my-namespace')

// Or auto-generated name
const namespace = await smithery.namespaces.create()

# Auto-generated name
curl -X POST https://api.smithery.ai/namespaces \
  -H "Authorization: Bearer YOUR_API_KEY"

# Specific name
curl -X PUT https://api.smithery.ai/namespaces/my-namespace \
  -H "Authorization: Bearer YOUR_API_KEY"

Namespace names must be lowercase alphanumeric with hyphens, and are globally unique across Smithery.

Limits

Plan	Max namespaces
Hobby (free)	3
Pay as you Go	100
Custom	100+

See the pricing page for full plan details. Namespaces act as a shared workspace. Resources within a namespace can be managed by anyone with the appropriate API key scoped to that namespace, making them suitable for team collaboration similar to project IDs.

Getting Started

Clients

Servers

Integrations

Concepts

Cookbooks

API Reference

Namespaces

Namespaces

What belongs to a namespace?

Creating a namespace

Limits

Getting Started

Clients

Servers

Integrations

Concepts

Cookbooks

API Reference

​Namespaces

​What belongs to a namespace?

​Creating a namespace

​Limits

​Sharing and collaboration

Namespaces

What belongs to a namespace?

Creating a namespace

Limits

Sharing and collaboration