​ 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/servers/acme/weather.

​ What belongs to a namespace?

​ 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

See the pricing page for full plan details.

​ Sharing and collaboration

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.

Was this page helpful?

YesNo

⌘I