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

# Management MCP (Beta)

> Manage a Nango environment from an MCP client.

<Note>
  The Management MCP server is in Beta. We will continue to add functionality, with the goal of supporting the full public API. This means we may introduce breaking changes along the way. We would love to hear your feedback and requests!
</Note>

The Management MCP server lets MCP-compatible clients manage Nango through tools. It is an agent-friendly alternative to the [public API](/docs/reference/backend/http-api/authentication).

## Connect

The server uses the Streamable HTTP transport at:

```text theme={null}
https://mcp.nango.dev/mcp
```

Configure your MCP client to send a Nango API key as a Bearer token:

| Header          | Value                    |
| --------------- | ------------------------ |
| `Authorization` | `Bearer <NANGO-API-KEY>` |

Manage API keys in **Environment Settings > API Keys** in the Nango UI. The API key determines which Nango environment the client can access. To limit what the MCP client can do, you can [scope down the API key](/docs/reference/backend/http-api/api-keys#scopes) to only the tools it needs. The required scope for each tool is listed below.

<Note>
  The `environment:mcp` scope is not required for Management MCP tools. That scope is used by the separate [action-function MCP server](/docs/guides/functions/tool-calling#mcp-server), which exposes enabled action functions as tools.
</Note>

Keep the API key server-side and only configure it in MCP clients you trust. Do not expose it in client-side code, logs, or URLs.

## Tools

### Documentation

Use the Documentation tools to search the Nango documentation and read complete pages from Mintlify's virtual documentation filesystem. Start with `docs_search` for broad or conceptual queries, then use `docs_query_filesystem` to read a relevant `.mdx` path or perform an exact text search.

These tools require a valid Management MCP API key but no additional environment operation scope. If Mintlify rate-limits a request, the tool error points to the public Nango documentation MCP at `https://nango.dev/docs/mcp` so you can connect to it directly.

| Tool                    | Description                                                              | Required API key scope |
| ----------------------- | ------------------------------------------------------------------------ | ---------------------- |
| `docs_search`           | Search the Nango documentation and return contextual snippets and links. | None                   |
| `docs_query_filesystem` | Read and query Mintlify's virtual Nango documentation filesystem.        | None                   |

### Connect sessions

Use the Connect Session tools to start an authorization flow for an end user.

| Tool                     | Description                                | Required API key scope               |
| ------------------------ | ------------------------------------------ | ------------------------------------ |
| `connect_session_create` | Create a new Connect session and its link. | `environment:connect_sessions:write` |

### Integrations

Use the Integrations tools to inspect and manage integrations in the authenticated Nango environment.

| Tool                  | Description                                                                                     | Required API key scope                                                         |
| --------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `integrations_list`   | List integrations configured in the environment.                                                | `environment:integrations:list`                                                |
| `integrations_get`    | Get a configured integration by ID.                                                             | `environment:integrations:read` or `environment:integrations:read_credentials` |
| `integrations_create` | Create an integration with caller-supplied or Nango-provided developer application credentials. | `environment:integrations:create`                                              |
| `integrations_update` | Update a configured integration by ID.                                                          | `environment:integrations:update`                                              |
| `integrations_delete` | Delete a configured integration by ID.                                                          | `environment:integrations:delete`                                              |

### Connections

Use the Connections tools to inspect connections in the authenticated Nango environment. Connection list results never include credentials. Getting a connection only includes credentials when the API key has the credential-reading scope.

| Tool               | Description                                                                                                                                           | Required API key scope                                                       |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| `connections_list` | List and filter connections.                                                                                                                          | `environment:connections:list` or `environment:connections:list_credentials` |
| `connections_get`  | Get a connection and its current credential state. Credential access and refresh flags require `read_credentials` and may rotate credential material. | `environment:connections:read` or `environment:connections:read_credentials` |

### Proxy requests

Use the Proxy tool to make authenticated HTTP requests to a provider API through an existing connection. The tool supports `GET`, `POST`, `PUT`, `PATCH`, and `DELETE`, along with query parameters, headers, request bodies, base URL overrides, and up to 5 retries. It returns the provider response status, headers, and body.

The tool accepts JSON and UTF-8 text responses up to 5 MB (5,000,000 bytes). Unsafe JSON integers and high-precision decimals are returned as strings so their values are not rounded. Binary responses, other character encodings, and responses over 5 MB return a tool error. Use the matching [Proxy HTTP API endpoint](/docs/reference/backend/http-api/proxy/get) for those responses.

| Tool            | Description                                                     | Required API key scope |
| --------------- | --------------------------------------------------------------- | ---------------------- |
| `proxy_request` | Make an authenticated request through the Nango requests proxy. | `environment:proxy`    |

### Functions

Use the Functions tools to inspect functions deployed to an integration in the authenticated Nango environment.

| Tool             | Description                                                                   | Required API key scope       |
| ---------------- | ----------------------------------------------------------------------------- | ---------------------------- |
| `functions_list` | List and filter deployed syncs, actions, and on-event scripts by integration. | `environment:functions:list` |

### Logs

Use the Logs tools to find activity in the authenticated Nango environment and inspect the messages for a specific operation.

| Tool                   | Description                            | Required API key scope  |
| ---------------------- | -------------------------------------- | ----------------------- |
| `logs_list_operations` | List and filter log operations.        | `environment:logs:read` |
| `logs_get_operation`   | Get an operation and its log messages. | `environment:logs:read` |

See [Observability](/docs/guides/platform/observability) for more information about Nango logs.