> ## Documentation Index
> Fetch the complete documentation index at: https://smithery.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Namespaces

> Namespaces group your servers, connections, and skills under a shared identifier.

# 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?

| Resource                                  | Description                                               |
| ----------------------------------------- | --------------------------------------------------------- |
| **[Servers](/docs/api-reference/servers)**     | MCP servers you publish to the Smithery registry          |
| **[Connections](/docs/api-reference/connect)** | Managed MCP connections with OAuth and credential storage |
| **[Skills](/docs/api-reference/skills)**       | Reusable AI skills that reference MCP servers             |

## Creating a namespace

You can create namespaces via the [Namespaces API](/docs/api-reference/namespaces):

<Tabs>
  <Tab title="CLI" icon="terminal">
    ```bash theme={null}
    smithery namespace create my-namespace
    ```
  </Tab>

  <Tab title="TypeScript" icon="braces">
    ```typescript theme={null}
    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()
    ```
  </Tab>

  <Tab title="cURL" icon="globe">
    ```bash theme={null}
    # 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"
    ```
  </Tab>
</Tabs>

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](https://smithery.ai/pricing) 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](/docs/use/token-scoping) scoped to that namespace, making them suitable for team collaboration similar to project IDs.