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

# MCP Integration

> Connect AI assistants to Nonce through Model Context Protocol

Nonce provides an [MCP](https://modelcontextprotocol.io/) server that lets AI assistants manage your mining operations through natural language.

## How Nonce MCP works

After OAuth authorization, AI clients use Nonce MCP to call Public API v2. The current account's permissions determine which workspaces and farms are accessible.

![MCP clients connect to Nonce MCP, which calls Public API v2.](https://mintcdn.com/nonce/b9KVJ-OYoCYG9adE/images/api/nonce-mcp-flow-light.svg?fit=max\&auto=format\&n=b9KVJ-OYoCYG9adE\&q=85\&s=987a670004ded0884af38284c392adc1)

## Server URL

```
https://mcp.nonce.app/mcp
```

## Connect from Your AI Client

**Claude**

1. Open **Settings** > **Connectors**
2. Click **Add custom connector**
3. Enter the server URL: `https://mcp.nonce.app/mcp`
4. Click **Add** to finish
5. Enable it per chat via the **+** menu > **Connectors**, then complete the OAuth sign-in when prompted

> [!NOTE]
>
> On Team / Enterprise workspaces, an Owner must first add the connector under **Organization settings** > **Connectors**; members then connect from their own Connectors page.

**ChatGPT**

1. Open **Settings** > **Connectors** and click **Create**
2. Fill in the connector name, description, and URL: `https://mcp.nonce.app/mcp`
3. Click **Create** and confirm that the tools list loads successfully
4. In a new chat, click **+** > **More**, select the Nonce connector, and complete the OAuth sign-in when prompted

> [!NOTE]
>
> Custom MCP requires enabling **Developer mode** under **Settings** > **Connectors**; write-capable full MCP is limited to Business / Enterprise / Education workspaces.

## Authentication

When you first connect, you will be redirected to sign in with your Nonce account. After authorization, the MCP client handles token management automatically.

> [!NOTE]
>
> MCP uses the same account and permissions as the Nonce web app. See [Permissions](https://docs.nonce.app/user-guide/permissions/index.md) for details on what each role can access.

## What You Can Do

Once connected, your AI assistant can:

* **Query** farm and miner status in real time
* **Monitor** hashrate, temperature, and pool configuration changes
* **Execute** batch operations like reboots across miners
* **Track** task execution history and results

See [Available Tools](https://docs.nonce.app/api-guide/mcp/tools.md) for the full list.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.