> For the complete documentation index, see [llms.txt](https://shinkalabs.gitbook.io/hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shinkalabs.gitbook.io/hub/andromeda/getting-started/mcp.md).

# Connect via MCP

Andromeda runs an MCP server at `https://api.andromedainfra.pro/mcp`. Add it to any MCP client and the agent gets around 65 tools, one per REST route, covering wallet creation and signing, recovery, policy operations, future-sign, webhooks, audit-log queries and the Encrypt FHE surface.

The quickest thing to try once connected: ask the agent to **create a dWallet**. It will prompt you for a passphrase, call `create_dwallet`, and return the new cross-chain wallet's address — no SDK, no seed phrase, no node, no client install on your side. (Andromeda runs the 2PC-MPC DKG server-side and stores the wallet's key wrapped under your passphrase — see [Create a dWallet](/hub/andromeda/getting-started/create-dwallet.md) for the custody model.)

## Configuration

Most MCP clients use a JSON config like this:

```json
{
  "mcpServers": {
    "andromeda": {
      "url": "https://api.andromedainfra.pro/mcp",
      "headers": {
        "X-Api-Key": "<ANDROMEDA_KEY>"
      }
    }
  }
}
```

* **Claude Desktop**: add the block to your MCP servers configuration.
* **Cursor**: add it to the MCP settings.
* **Custom clients**: point your MCP transport at the `/mcp` URL with the `X-Api-Key` header set. The server speaks streamable HTTP.

## What the key controls

The same rules as REST apply. A key without `write` cannot call mutating tools; admin-only tools (webhooks, audit, policies, future-sign) need the `admin` scope. Each tool call charges quota at the cost of the equivalent REST call. See [Authentication](/hub/andromeda/getting-started/auth.md).

## Idempotency

Tool calls honour the `Idempotency-Key` mechanism: the same body with the same key replays the previous response. See [Idempotency keys](/hub/andromeda/guides/idempotency.md).

## Next

* [Tool catalogue](/hub/andromeda/mcp-reference/tools.md): what is exposed and how tools are named.
* [Examples](/hub/andromeda/mcp-reference/examples.md): example agent flows.
* [Connect](/hub/andromeda/mcp-reference/connect.md): per-client setup details.


---

# 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:

```
GET https://shinkalabs.gitbook.io/hub/andromeda/getting-started/mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.