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

# MCP overview

> Connect AI tools to Amazonomics data over the Model Context Protocol

The Amazonomics MCP server lets AI tools query Amazon search-term rankings directly. Ask Claude "how did matcha searches trend this year?" and it can pull the real numbers.

The server URL is:

```
https://mcp.amazonomics.com/mcp
```

MCP access is part of the Pro and Studio plans.

## How it connects

The server uses the Streamable HTTP transport and OAuth for login. You do not need an API key. When you add the server to a client:

1. The client registers itself with Amazonomics automatically.
2. Your browser opens the Amazonomics login page.
3. You sign in and approve the connection.

The connection uses your account and your organization's plan. The plan sets the data window: the last 24 monthly periods on Pro, all periods on Studio.

## Tools

The server exposes two tools:

| Tool              | What it does                                       |
| ----------------- | -------------------------------------------------- |
| `search_keywords` | Search rank history for one or more keywords.      |
| `search_asin`     | Find the keywords that rank for one or more ASINs. |

See the [tool reference](/mcp/tools) for parameters and defaults.

## Set up your client

<CardGroup cols={3}>
  <Card title="Claude" icon="message" href="/mcp/claude">
    Claude.ai, Claude Desktop, and Claude Code.
  </Card>

  <Card title="Cursor" icon="arrow-pointer" href="/mcp/cursor">
    Add the server to Cursor.
  </Card>

  <Card title="Other clients" icon="plug" href="/mcp/other-clients">
    Any MCP client with OAuth support.
  </Card>
</CardGroup>