Catchr MCP connector for AI agents

CALL ANY TOOL

Marketing data end to end: list connected platforms and accounts, explore the field catalog, and run metric queries across ad sources.

catchrmcp_list_platforms

List platforms

List Catchr platforms, optionally narrowed to only the platforms connected for the authenticated company.

Parameters

Name

Type

Required

Description

connectedOnly

boolean

Optional

When true, return only platforms that are connected for the authenticated company.

catchrmcp_list_sources

List sources

catchrmcp_list_available_accounts

List ad accounts

catchrmcp_list_fields_by_platform

List platform fields

catchrmcp_list_fields_for_account

List account fields

catchrmcp_list_all_fields

Browse field catalog

catchrmcp_describe_run_api_request_schema

Get query schema

catchrmcp_run_api_request_json

Run a data query

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Catchr tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["catchrmcp"], toolNames: [
    "catchrmcp_list_available_accounts",
    "catchrmcp_list_fields_by_platform",
    "catchrmcp_run_api_request_json"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "How did Google Ads spend trend last week?" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["catchrmcp"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Which ad platforms are connected for this company?" }],
  tools,
});

// Execute the tool call with the user's vaulted Catchr credential
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["catchrmcp"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Compare CPC across Google Ads and Facebook Ads this month." }],
  tools,
});

// Tool call runs with the user's vaulted Catchr credential
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["catchrmcp"] }, pageSize: 100,
});

const agent = new Agent({
  name: "catchr_reporting_agent",
  model: "gemini-2.5-pro",
  instruction: "Answer marketing data questions for the signed-in user.",
  tools,
});

await agent.run("Which campaigns had the highest ROAS last month?");

Try these prompts

Copy any prompt into your agent. Each maps directly to a Catchr tool. Click to copy, paste into your agent, done.

Ad performance

Copy the prompt

Copied

How did Google Ads spend trend last week versus the week before?

Copy the prompt

Copied

Which campaigns had the highest ROAS last month?

Copy the prompt

Copied

Pull impressions, clicks, and CPC for the top 10 Facebook ad sets.

Explore sources and fields

Copy the prompt

Copied

Which ad platforms are connected for this company?

Copy the prompt

Copied

List the ad accounts available under our Google Ads authorization.

Copy the prompt

Copied

What conversion fields does Catchr expose for Facebook Ads?

Cross-platform reporting

Copy the prompt

Copied

Compare CPC across Google Ads and Facebook Ads this month.

Copy the prompt

Copied

Build a weekly spend summary across every connected account.

Copy the prompt

Copied

Total conversions by platform for Q2, sorted highest first.

SEE HOW AUTH WORKS

Your users connect once. Their Catchr credentials stay vaulted, every call is scope-checked, and every action is logged.

1

Authorize

Your user connects

Catchr MCP

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

2

Store

Their

Catchr MCP

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

3

Resolve

When your agent calls a

Catchr MCP

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

4

Audit

Every

Catchr MCP

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other analytics connectors.

SALES

Deal intelligence agent

Combine Gong, Attio, and Slack signals to surface deal risks and next-best actions. Updated after every call.

ENGINEERING

Engineering standup agent

Aggregate GitHub and GitLab activity, link to Jira, and post a daily standup digest to Slack. No async updates.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

Other connector libraries treat auth as a demo afterthought. Scalekit starts with identity, scope enforcement, and audit. Connectors follow.

01.

Shared tokens break per-user analytics

A shared Catchr key looks fine in a demo. In production every metric query across every client's ad accounts looks like one service account, and you cannot tell who pulled which numbers. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared key
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Catchr today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Catchr as the user or through a shared key?

As the user. Scalekit resolves the credential of the person who triggered the agent at request time, so every metric query in your audit trail is attributed to a real user, not a shared service account.

Where is the Catchr API key stored?

In an AES-256 encrypted vault with per-tenant namespacing. Keys are resolved at request time, never enter LLM context, and can be rotated or revoked from one dashboard.

Can I limit what the agent does in Catchr?

Yes. Filter by tool name in listScopedTools to expose only what you want, for example field discovery without run_api_request_json. Scalekit also enforces scope checks before every API call.

What happens when a user revokes access?

The credential is invalidated at the next tool call. The call fails closed, other users' connections are unaffected, and the revocation is logged in the audit chain.

Which ad accounts can the agent actually query?

Only the accounts under the network authorizations your company connected in Catchr. The agent discovers them with list_sources and list_available_accounts, and every run_api_request_json call is scoped to those accounts and logged with the requesting user.

Catchr MCP

Tools your reporting agent reaches for on Catchr, scoped per user.