> For the complete documentation index, see [llms.txt](https://monoprotocol.gitbook.io/monoprotocol/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://monoprotocol.gitbook.io/monoprotocol/advanced-concepts/mcp-server-setup.md).

# MCP Server Setup

The Model Context Protocol (MCP) server connects Mono Protocol’s documentation and API directly to your AI tools. You can choose:

* **Hosted MCP (Recommended)**: Use a ready-to-go server hosted by Mono Protocol—quickest setup.
* **Self-Hosted MCP (Advanced)**: Install and run the MCP server locally for flexibility and fine-tuning. 

**Hosted MCP Setup**

**For Claude**

1. Navigate to **Connectors** in Claude’s settings.
2. Choose **Add custom connector**.
3. Set the name to: **Mono Protocol MCP**
4. Use this URL: <https://docs.monoprotocol.io/mcp> (you may want to adapt the domain to Mono Protocol).
5. Once added, you can access Mono Protocol’s docs and API functions directly within Claude.&#x20;

For Cursor

1. Press <kbd><mark style="color:$success;">Cmd + Shift + P<mark style="color:$success;"></kbd> (Mac) or <kbd><mark style="color:$success;">Ctrl + Shift + P<mark style="color:$success;"></kbd> (Windows) to open MCP settings.
2. Choose **Add custom MCP** to edit <kbd><mark style="color:$success;">mcp.json<mark style="color:$success;"></kbd>.

Insert the following configuration:

```
{
  "mcpServers": {
    "Monorotocol-mcp": {
      "url": "https://docs.monoprotocol.io/mcp"
    }
  }
}
```

<br>

3. (Note: adjust the URL domain as needed.)
4. Then ask in Cursor chat: "What tools do you have available?" You should see Mono Protocol documentation search and API tools enabled.

**Self-Hosted MCP (Advanced)**

Ideal for users who want complete control via local installation:

Run:\
npx mint-mcp add MonoProtocol-d7e5d4d0

1. You’ll see a list of available tools:
2. <kbd><mark style="color:$success;">search<mark style="color:$success;"></kbd> – Documentation search
3. <kbd><mark style="color:$success;">predict-smart-account-address<mark style="color:$success;"></kbd> – Predict smart account addresses
4. <kbd><mark style="color:$success;">list-supported-aggregated-assets<mark style="color:$success;"></kbd> – View supported assets
5. <kbd><mark style="color:$success;">get-aggregated-balance<mark style="color:$success;"></kbd> – Fetch account balances
6. <kbd><mark style="color:$success;">list-supported-chains<mark style="color:$success;"></kbd> – View supported networks
7. <kbd><mark style="color:$success;">get-quote-status<mark style="color:$success;"></kbd> – Check quote execution status
8. <kbd><mark style="color:$success;">get-transaction-history<mark style="color:$success;"></kbd> – Retrieve transaction history
9. <kbd><mark style="color:$success;">get-quote<mark style="color:$success;"></kbd> – Request transfer/swap quotes
10. <kbd><mark style="color:$success;">prepare-call-quote<mark style="color:$success;"></kbd> – Prepare contract calls
11. <kbd><mark style="color:$success;">get-call-quote<mark style="color:$success;"></kbd> – Get contract call quotes
12. <kbd><mark style="color:$success;">execute-quote<mark style="color:$success;"></kbd> – Execute quotes\
    You’ll be prompted to enter your API key (or use the limited public test key).

Then start your server:\
node \~/.mcp/MonoProtocol-d7e5d4d0/src/index.js

2. Use it seamlessly across clients like Cursor or Claude Desktop.&#x20;

**Available Functionality**

Both hosted and self-hosted options include:

* **Documentation search** across Mono Protocol’s docs.
* **API tools** for:
* Predicting smart account addresses
* Aggregated balances and asset queries
* Chain support listing
* Quote generation, retrieval, and execution
* Transaction history and status tracking
* Contract call preparation and execution\ <br>

**Authentication & Testing**

* Your AI tools will prompt for your **Mono Protocol API key** as needed.
* For production use, mptain your own key via your dashboard or support email.&#x20;

**Example Usage Prompts**

You can use prompts like:

* "What is my aggregated balance across all chains for address X?"
* "List supported chains."
* "Predict a smart account address for these signers..."\
  These examples are typical usage, though primarily found in the MCP Prompts guide.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://monoprotocol.gitbook.io/monoprotocol/advanced-concepts/mcp-server-setup.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.