Catchr MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'catchrmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Catchr MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'catchrmcp_list_all_fields',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "catchrmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Catchr MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="catchrmcp_list_all_fields",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Run api request json, describe — Execute the Catchr API request in JSON mode for one or multiple accounts
• List sources, platforms, fields for account — List network authorizations (sources) for the authenticated company, with optional available accounts

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

catchrmcp_describe_run_api_request_schema#Return the detailed input schema and filter guide for run_api_request_json.0 params▾

Return the detailed input schema and filter guide for run_api_request_json.

catchrmcp_list_all_fields#List all published fields across all platforms from Catchr field catalog.1 param▾

List all published fields across all platforms from Catchr field catalog.

NameTypeRequiredDescription

groupByPlatformbooleanoptionalWhen true, fields are grouped per platform in the response.

catchrmcp_list_available_accounts#List available accounts for a platform and company, optionally scoped to one authorization.4 params▾

List available accounts for a platform and company, optionally scoped to one authorization.

NameTypeRequiredDescription

platformstringrequiredCatchr platform identifier.

authorizationIdstringoptionalFilter accounts to those belonging to a specific authorization source.

includeParentAccountsbooleanoptionalWhen true, include parent-level accounts in the response.

parentAccountIdstringoptionalFilter to children of a specific parent account ID.

catchrmcp_list_fields_by_platform#List all fields for one platform. Includes calculated/runtime fields when available.2 params▾

List all fields for one platform. Includes calculated/runtime fields when available.

NameTypeRequiredDescription

platformstringrequiredCatchr platform identifier (for example: "facebook-ads").

reportstringoptionalOptional provider report key used by restricted field providers.

catchrmcp_list_fields_for_account#List all fields for a specific account and authorization pair on a platform.4 params▾

List all fields for a specific account and authorization pair on a platform.

NameTypeRequiredDescription

accountIdstringrequiredThe account ID scoped to the platform.

authorizationIdintegerrequiredThe authorization (source) ID linked to this account.

platformstringrequiredCatchr platform identifier.

reportstringoptionalOptional provider report key used by restricted field providers.

catchrmcp_list_platforms#List Catchr platforms. You can list only connected platforms for the authenticated company.1 param▾

List Catchr platforms. You can list only connected platforms for the authenticated company.

NameTypeRequiredDescription

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

catchrmcp_list_sources#List network authorizations (sources) for the authenticated company, with optional available accounts.2 params▾

List network authorizations (sources) for the authenticated company, with optional available accounts.

NameTypeRequiredDescription

includeAvailableAccountsbooleanoptionalWhen true, include the list of available accounts for each source.

platformstringoptionalFilter sources to a specific platform identifier.

catchrmcp_run_api_request_json#Execute the Catchr API request in JSON mode for one or multiple accounts.14 params▾

Execute the Catchr API request in JSON mode for one or multiple accounts.

NameTypeRequiredDescription

accountsarrayrequiredOne or more accounts to include in the request. Each entry requires id and authorization_id.

platformstringrequiredCatchr platform identifier.

datestringoptionalPreset date range or CUSTOM to use start_date/end_date.

dimensionsarrayoptionalList of dimension field keys to break down the data by.

end_datestringoptionalEnd date in YYYY-MM-DD format. Required when date is CUSTOM.

filtersarrayoptionalList of filter conditions to apply to the query.

include_current_datebooleanoptionalWhether to include the current (partial) date in the results.

max_rowsintegeroptionalMaximum number of rows to return. Minimum 1.

metricsarrayoptionalList of metric field keys to include in the response.

offset_timestringoptionalTimezone offset in hours applied to date boundaries.

optionsobjectoptionalAdditional platform-specific options as a JSON object.

sincestringoptionalISO 8601 timestamp used when date is SINCE.

sortsarrayoptionalList of sort instructions applied to the result set.

start_datestringoptionalStart date in YYYY-MM-DD format. Required when date is CUSTOM.