MCP

# Every number here, inside your own AI.

Marley is a Model Context Protocol server. Connect it to Claude, or to whatever you build, and your market intelligence becomes something you ask for in a sentence — no dashboard, no export, no copying figures into a document.

[Start free](https://askmarley.ai/signup/) [MCP is on every plan](https://askmarley.ai/pricing/)

It reads, and it writes

## Ask it anything. Then tell it what to do.

Everything the interface shows is a question your agent can ask directly. Agents can also add and remove monitored keywords and request a capture on the spot — a workspace can be run entirely from an AI client, and some are.

Read

Share of Screen, competitive states, brand protection, AI Overview presence, Shopping, competitor creative.

Write

Track and untrack keywords, change how often one is captured, scan one now instead of waiting for the cycle, rebuild your clusters.

One place the limits live

A scan requested by an agent is counted exactly like one requested by a person, so an agent-driven workspace behaves — and bills — the same as a human-driven one.

The tools it exposes

## 29 tools, plain answers.

24 that read and 5 that act; the ones asked for most are below. Each answers in your words — the competitive states, the reclaimable spend, the captured page — never in internal jargon.

### Your market

Where you stand, and how it is moving.

- How your market looks right now — share, competitors, movement. `get_market_overview`
- Every keyword's plain-language state and the reclaimable spend. `get_competitive_states`
- How one keyword has moved over your retention window. `get_keyword_trend`
- Everything currently monitored, with cadence and market. `list_tracked_keywords`

### Competitors

Who you meet, and what they are running.

- One advertiser on your keywords — share, presence, the ads they run against you. `get_competitor_profile`
- Who contests a group of keywords, paid and organic. `get_cluster_competitors`
- The captured result page for one keyword and market. `get_keyword_serp`
- Competitor headlines, offers and sitelinks over time. `get_ad_copy_insights`

### Brand & AI

Your brand terms, the AI answers, the Shopping shelf.

- Who is advertising on your brand terms, classified. `get_brand_protection`
- Where AI Overviews appear and who they cite. `get_aio_presence`
- Share of shelf and price position on Shopping. `get_shopping_insights`
- Keywords nobody contests where you already own the organic result. `find_uncontested_owned`

### Then it acts

The five tools that change something.

- Add a keyword and market to monitoring. `track_keyword`
- Stop monitoring one. `untrack_keyword`
- Change how often a keyword is captured. `set_keyword_cadence`
- Capture a keyword now instead of waiting for the cycle. `request_keyword_scan`
- Recompute the workspace's keyword clusters. `rebuild_clusters`

## Connecting it

One entry in your client, one token, no SDK to install.

### Copy your connector URL

Every workspace gets its own endpoint and an access token, both visible in settings whenever you need them again.

### Add it to your client

Claude, or any MCP-capable client you use. One entry, one token, no SDK to install.

### Ask it something

“What did we lose share on this week?” is a reasonable first question, and the answer comes back with the keywords attached.

Scopes

## Permissions

Clients that connect over OAuth ask for one or both scopes. Ask for `marley:read` unless the agent has to add, remove or rescan keywords, change a keyword's cadence, or rebuild clusters. A read-only token that calls a write tool is refused. The [protected-resource metadata](https://mcp.askmarley.ai/.well-known/oauth-protected-resource/mcp) and the [authorization-server metadata](https://mcp.askmarley.ai/.well-known/oauth-authorization-server) describe the rest.

### marley:read

Every tool that only reads.

- All 24 read tools `list_tracked_keywords · get_coverage · list_clusters · get_market_trend · get_keyword_serp · get_keyword_trend · get_cluster_competitors · get_competitor_profile · get_aio_presence · find_uncontested_owned · get_market_overview · get_share_of_screen · get_brand_protection · get_aio_impact · get_ad_copy_insights · get_competitive_states · get_shopping_insights · get_ai_mode_presence · get_auction_insights · get_advertiser_disclosures · get_marley_score · get_search_demand · get_autopilot_status · get_search_questions`

### marley:write

The tools that change monitoring or clustering, or spend crawls.

- Add a keyword and market to monitoring. `track_keyword`
- Stop monitoring one. `untrack_keyword`
- Change how often a keyword is captured. `set_keyword_cadence`
- Capture a keyword now instead of waiting for the cycle. `request_keyword_scan`
- Recompute the workspace's keyword clusters, replacing the stored ones. `rebuild_clusters`

## Available on every plan, including free.

[Start free](https://askmarley.ai/signup/) [See what it measures](https://askmarley.ai/platform/)

---

This is the Markdown rendering of https://askmarley.ai/mcp/. Every page on this site is listed, with when to use Marley, in https://askmarley.ai/llms.txt
