MCP Tools
Agent tools exposed over Reeve's MCP server (tools/list) — the unified progressive surface at /mcp.
Reeve exposes agent tools over the Model Context Protocol at https://api.meetreeve.com/mcp. Generated from its live tools/list. See HTTP or MCP for how this relates to the REST API, and Use Reeve in Claude for the end-user connect flow.
/mcp — unified, progressive surface
The brain tools (chat, get_context, resolve_gate, reeve_howto) and meta tools (list_tools, describe_tools, use) are always present. Promoted tools are a capability-filtered subset — you'll only see the ones your connection is granted.
get_context
brain tool — listed on both the flat and progressive surfaces, never capability-filtered
Who you are in Reeve: orgs, user, brands, host_apps — plus the departments of tools available here. Start every session with this.
No parameters.
list_tools
meta tool — progressive surface only
List available Reeve tools (name + one-line description). Pass department (from get_context) to narrow; omit for all.
| Name | Type | Required | Description |
|---|---|---|---|
department | string | no |
describe_tools
meta tool — progressive surface only
Full input schemas for up to 10 tools you're about to call via use.
| Name | Type | Required | Description |
|---|---|---|---|
names | array | yes |
use
meta tool — progressive surface only
Call a Reeve tool by name with a JSON args object matching its schema (see describe_tools). Optional host_app picks which of your org's host apps the call acts as (default: oldest granted).
| Name | Type | Required | Description |
|---|---|---|---|
tool | string | yes | |
args | object | no | |
host_app | string | no |
chat
brain tool — listed on both the flat and progressive surfaces, never capability-filtered
Talk to the Reeve agent (the brain): renders, brand questions, campaign work. Pass the returned thread_id on follow-ups. Prefer direct tools for deterministic reads; chat for orchestrated work.
| Name | Type | Required | Description |
|---|---|---|---|
message | string | yes | |
thread_id | string | no | |
host_app | string | no | |
brand_id | string | no |
resolve_gate
brain tool — listed on both the flat and progressive surfaces, never capability-filtered
Approve or cancel a pending gated action from a previous reply. Only call after the user explicitly confirmed. decision: approve|cancel. thread_id is only needed for a chat-originated gate — a gate returned by a direct tool call (gate_id from a pending_approval result) resolves without one.
| Name | Type | Required | Description |
|---|---|---|---|
thread_id | string | no | |
gate_id | string | yes | |
decision | string | yes |
reeve_howto
brain tool — listed on both the flat and progressive surfaces, never capability-filtered
How to accomplish a stated goal with Reeve's tools — semantic help over the knowledge base (knowledge_list_ask with a job description). Returns matching guidance cards, or an honest empty result with a next-step hint when nothing matches — never a fabricated answer. Once you know which tool to call, use describe_tools for its exact schema.
| Name | Type | Required | Description |
|---|---|---|---|
task | string | yes | |
host_app | string | no |
crm_list_contacts
promoted read — first-class named tool, capability-gated · department: crm · gate: read
Filter by tags, lifecycle stage, host app, name; cursor-paginate.
| Name | Type | Required | Description |
|---|---|---|---|
tags_any | no | ||
tags_all | no | ||
lifecycle | no | ||
host_app | no | ||
q | no | ||
limit | integer | no | |
cursor | no |
crm_list_stats
promoted read — first-class named tool, capability-gated · department: crm · gate: read
Return aggregate counts for the org+host combination: total contacts, active contacts, interactions in the last 30 days, and audience count.
No parameters.
credits_get_balance
promoted read — first-class named tool, capability-gated · department: credits · gate: read
Return the owner's credit balance (total, base, top-up, and expiring-soon)
| Name | Type | Required | Description |
|---|---|---|---|
owner_id | string | yes | |
owner_type | string | no | Which credit ledger to read/write. Accounts key on (host_app, owner_type, owner_id), so user and org are two SEPARATE, non-fungible ledgers. Picking the wrong one returns that ledger's real balance (often 0), not an error. |
credits_get_ledger
promoted read — first-class named tool, capability-gated · department: credits · gate: read
Owner-scoped credit ledger (transaction history), newest-first, keyset-paginated.
| Name | Type | Required | Description |
|---|---|---|---|
owner_id | string | yes | |
owner_type | string | no | |
limit | integer | no | |
cursor | no | ||
kind | no |
commerce_get_rate_card
promoted read — first-class named tool, capability-gated · department: commerce · gate: read
Return the public per-action rate card for the given host app — live credit costs, the canonical $/credit rate, and editorial pricing categories (404 if no catalog).
| Name | Type | Required | Description |
|---|---|---|---|
host_app | string | yes |
connects_list_connections
promoted read — first-class named tool, capability-gated · department: connects · gate: read
List the tenant's stored provider connections, optionally filtered by provider.
| Name | Type | Required | Description |
|---|---|---|---|
provider | no |
connects_list_capabilities
promoted read — first-class named tool, capability-gated · department: connects · gate: read
Return the registered providers and their available actions and reads, optionally filtered by provider.
| Name | Type | Required | Description |
|---|---|---|---|
provider | no |
ads_list_providers
promoted read — first-class named tool, capability-gated · department: adbuyer · gate: read
List the ad providers this organization has connected and the reads each supports.
No parameters.
ads_list_campaigns
promoted read — first-class named tool, capability-gated · department: adbuyer · gate: read
List the org's ad campaigns for provider (Meta / Google / TikTok).
| Name | Type | Required | Description |
|---|---|---|---|
provider | string | yes | Ad provider: meta_ads | google_ads | tiktok_ads |
advertiser_id | no | TikTok advertiser id (required for tiktok_ads campaign listing) | |
status | no | Optional campaign status filter (e.g. ACTIVE, PAUSED) |
ads_list_insights
promoted read — first-class named tool, capability-gated · department: adbuyer · gate: read
Campaign performance metrics for provider, optionally narrowed to one campaign and/or a date window.
| Name | Type | Required | Description |
|---|---|---|---|
provider | string | yes | Ad provider: meta_ads | google_ads | tiktok_ads |
campaign_id | no | Restrict to a single campaign (where the adapter supports it) | |
advertiser_id | no | TikTok advertiser id (single-advertiser insights) | |
level | no | Aggregation level, e.g. account | campaign | adset | ad | |
date_preset | no | Relative window, e.g. last_7d, last_30d, this_month | |
since | no | Start date YYYY-MM-DD (with until, a custom window) | |
until | no | End date YYYY-MM-DD (with since, a custom window) |
video_list_presets
promoted read — first-class named tool, capability-gated · department: studio · gate: read
Preset catalog for clip inserts — proxies reeve-remotion GET /presets
No parameters.
video_list_projects
promoted read — first-class named tool, capability-gated · department: studio · gate: read
Org-scoped project list, newest-updated first.
| Name | Type | Required | Description |
|---|---|---|---|
limit | integer | no | Max results returned; silently clamped to 200. |
offset | integer | no | Number of results to skip. |
video_get_renders
promoted read — first-class named tool, capability-gated · department: studio · gate: read
Get a reeve-video render's status, scoped to the caller's org.
| Name | Type | Required | Description |
|---|---|---|---|
render_id | string | yes |
knowledge_list_corpora
promoted read — first-class named tool, capability-gated · department: knowledge · gate: read
List the built knowledge corpora with per-corpus fact-card counts. The product lens (host-key) reports only product-visible digest counts as card_count; product_label is the customer-facing corpus name.
| Name | Type | Required | Description |
|---|---|---|---|
lens | string | no | product = host-key digests; technical = service-token raw (not reachable over MCP). |
brand | no | Studio brand (required on lens=product) — the corpora list is filtered to the brand's resolved repo set. |
knowledge_list_ask
promoted read — first-class named tool, capability-gated · department: knowledge · gate: read
Semantic Q&A over grounded fact-cards. lens=product (host-key auth) returns customer-framed prose with source links, scoped to the caller's granted capabilities.
| Name | Type | Required | Description |
|---|---|---|---|
q | string | yes | The question to answer. |
lens | string | no | product = host-key, customer-framed digest; developer = host-key (same gate as product), developer-framed API docs; technical = service-token, repo internals (not reachable over MCP). |
brand | no | Studio brand (required on lens=product). The server authorizes the brand against the caller's org and unions the brand's whole repo set. | |
top_k | integer | no | Maximum number of hits to return. |