> For the complete documentation index, see [llms.txt](https://docs.noya.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.noya.ai/noya-hud/mcp-and-api.md).

# MCP and API

Noya is the trading layer for any AI app. Everything Noya HUD can do is also an MCP tool.

#### MCP server

The Noya MCP server is at <https://mcp.noya.ai>.

Connect Claude, ChatGPT, Cursor or any MCP app. You choose the profile the app may touch and whether it may trade, and you can disconnect whenever you like.

To add it to Claude Code:

```
claude mcp add --transport http noya https://mcp.noya.ai
```

Run it once. A Noya sign-in opens on first use.

#### What a connected app may do

* Read your portfolio and markets
* Trade within the limits you set, if you allow trading
* Change limits or withdraw: never available to apps

Noya HUD, your agents, your keys and every connected app go through one permission policy, checked on every request.

#### API

Scripts get the same capabilities with an API key. Create a key in Settings, under API keys.

Send a POST request to `https://api.noya.ai/q/<query>` with your key in the Authorization header as a Bearer token and a JSON body. For example, the query `portfolio.summary` with the body `{"input":{}}` returns your net worth with a breakdown by venue and by chain.
