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

# MCP server

> Connect AI agents to Signa's trademark data in natural language

The Signa MCP (Model Context Protocol) server lets AI agents like Claude, ChatGPT, and Cursor search and analyze trademark data conversationally. Ask a question in plain language and get a structured answer backed by live trademark-office data, without copy-pasting API responses into chat. Every query runs as your organization, scoped exactly like the REST API.

## Connect

Signa runs a **hosted** MCP server. There's no package to install and no local process to run, most clients just need one URL:

```
https://api.signa.so/mcp
```

For Claude Code, that's a single command:

```bash theme={null}
claude mcp add --transport http signa https://api.signa.so/mcp
```

Your client opens a browser to sign in, and you're connected.

<Tabs>
  <Tab title="Claude Desktop & Claude.ai">
    Add Signa as a **custom connector**: **Settings → Connectors → Add custom connector**, name it `Signa`, and enter `https://api.signa.so/mcp`. Save, then click **Connect** and complete the browser login.

    Or edit the config file directly and restart Claude Desktop:

    ```json theme={null}
    {
      "mcpServers": {
        "signa": {
          "url": "https://api.signa.so/mcp",
          "type": "streamableHttp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor">
    Add to `.cursor/mcp.json` (project) or your global Cursor MCP settings:

    ```json theme={null}
    {
      "mcpServers": {
        "signa": {
          "url": "https://api.signa.so/mcp"
        }
      }
    }
    ```

    Cursor discovers the OAuth flow automatically; **signa** appears under **MCP Tools** with a green status once connected.
  </Tab>

  <Tab title="ChatGPT">
    Requires a ChatGPT plan with MCP connectors enabled. Go to **Settings → Connectors → Create** (enable Developer mode if needed), enter `https://api.signa.so/mcp`, and choose **OAuth**.
  </Tab>

  <Tab title="VS Code">
    Add to `.vscode/mcp.json`, or run **MCP: Add Server** from the Command Palette:

    ```json theme={null}
    {
      "servers": {
        "signa": {
          "type": "http",
          "url": "https://api.signa.so/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Other clients">
    Any client that supports Streamable HTTP can connect directly to `https://api.signa.so/mcp` and will discover the OAuth flow via the `/.well-known/oauth-protected-resource` endpoint. For an API or enterprise product that doesn't support interactive OAuth, use a static Signa API key as `Authorization: Bearer sig_YOUR_KEY`.

    **Stdio-only client?** Bridge it with [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):

    ```json theme={null}
    {
      "mcpServers": {
        "signa": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://api.signa.so/mcp"]
        }
      }
    }
    ```
  </Tab>
</Tabs>

### Verify the connection

Ask your agent:

> "Use Signa to search for NIKE trademarks in the US."

You should see it call the `search_trademarks` tool and return live USPTO results.

## Authentication

Most clients use **OAuth**: your client opens a browser for you to sign in at app.signa.so and approve access, then refreshes the token silently, no key to paste or rotate. For scripts, CI, or headless setups, use a Signa API key as a bearer token instead (`Authorization: Bearer sig_YOUR_KEY`, or `--header "Authorization: Bearer sig_YOUR_KEY"` when adding the server). Either way, the tools available to a session depend on its scopes: see [Tools & permissions](/ai/mcp-tools) for the full list and what each tool requires.

## What you can ask

<Note>
  Your agent picks the right tools automatically, you don't need to name them. Edit the brand names, classes, and jurisdictions to fit your work.
</Note>

> "Search for trademarks similar to AURORA in Nice class 9 in the US."

> "Give me the full detail on trademark `tm_8kLm2nPq`, owners, classes, status, and any proceedings."

> "Who owns the most trademarks in the semiconductor space, and how big are their portfolios?"

> "Create a watch for new US filings phonetically similar to 'BRIGHTLY' in classes 9 and 42, then show me its status."

> "Which Nice classes should I file in for a company that sells smart home cameras and a subscription app?"

> "List TTAB oppositions filed against marks owned by Apple Inc. in the last 12 months."

For the full tool surface and worked recipes with the REST API, see [Tools & permissions](/ai/mcp-tools) and the [use-case guides](/guides/use-cases/trademark-clearance).