# Set up 3GPP Scout for this agent

Configure the current MCP client to use the hosted 3GPP Scout Streamable HTTP
server:

`https://api.3gppscout.com/mcp/`

Do not ask the user for a Scout API key. This MCP connection uses OAuth. Preserve
all existing MCP server entries and apply only the section matching the current
client.

## Cursor

Merge this entry into `.cursor/mcp.json` for the current project, or
`~/.cursor/mcp.json` for all projects:

```json
{
  "mcpServers": {
    "3gpp-scout": {
      "url": "https://api.3gppscout.com/mcp/"
    }
  }
}
```

Then enable or refresh `3gpp-scout` in Cursor Settings > Tools & MCP.

## Claude

For Claude Code, run:

```bash
claude mcp add --transport http --scope user 3gpp-scout https://api.3gppscout.com/mcp/
```

Then run `/mcp` in Claude Code and connect `3gpp-scout`. In Claude Desktop,
open Settings > Connectors, add a custom connector, and use
`https://api.3gppscout.com/mcp/` as the remote MCP URL.

## OpenAI Codex

Run:

```bash
codex mcp add 3gpp-scout --url https://api.3gppscout.com/mcp/
codex mcp login 3gpp-scout
```

## Generic MCP clients

Add a remote Streamable HTTP server named `3gpp-scout` with URL
`https://api.3gppscout.com/mcp/`. Clients using the common JSON format can
merge:

```json
{
  "mcpServers": {
    "3gpp-scout": {
      "url": "https://api.3gppscout.com/mcp/"
    }
  }
}
```

The client must support MCP OAuth 2.1 and Streamable HTTP. No static
`Authorization` header is needed.

## Authenticate on first use

The first connection or Scout tool call opens a browser for 3GPP Scout sign-in
and authorization. Complete that flow, return to the client, and retry the tool
call if the client does not retry automatically. The client stores and refreshes
its OAuth tokens; never paste those tokens into chat or configuration files.

## Verify the connection

Call the `list_documents` Scout tool with this small, filtered request:

```json
{
  "doc_number": "38.331",
  "release": "Rel-19"
}
```

Success is a short list containing indexed versions of TS 38.331. Do not verify
by listing the entire corpus. If authentication is requested, complete OAuth and
repeat the same filtered call.

Explorer includes 150 Scout retrieval requests per UTC calendar month. Founding
Engineer includes 1,000. Model
or agent charges from Cursor, Anthropic, OpenAI, or another provider are
separate from Scout usage.

For tool descriptions and research workflows, read
`https://api.3gppscout.com/skill.md`.