Profound 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 = 'profoundmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Profound 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: 'profoundmcp_list_models',
     toolInput: { rationale: 'YOUR_RATIONALE' },
   })
   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 = "profoundmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Profound MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={"rationale":"YOUR_RATIONALE"},
       tool_name="profoundmcp_list_models",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Whoami records — Confirm the authenticated user, organizations, regions, and entitlements available to this MCP session
• List topics, tags, regions — List topics available within a category for filtering prompts and reports
• Get visibility report, sentiment report, referrals report — Measure how often and how prominently a brand appears in AI answers for a category over a date range

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.

profoundmcp_get_bots_report#Measure AI crawler activity against a domain over a date range, including bots such as GPTBot and PerplexityBot.14 params▾

Measure AI crawler activity against a domain over a date range, including bots such as GPTBot and PerplexityBot.

NameTypeRequiredDescription

domainstringrequiredTracked domain using exact hostname from list_domains

end_datestringrequiredWindow end in YYYY-MM-DD format (exclusive)

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

start_datestringrequiredWindow start in YYYY-MM-DD format (inclusive)

bot_name_filterarrayoptionalNarrow to specific bots

bot_provider_filterarrayoptionalNarrow to specific bot providers

bot_type_filterarrayoptionalNarrow to bot categories

cursorstringoptionalPagination token

dimensionsarrayoptionalGroup-by fields

filtersarrayoptionalAdvanced predicates

limitintegeroptionalTop-N row cap

metricsarrayoptionalMetrics to return

organization_idstringoptionalDisambiguate domain across organizations

page_sizeintegeroptionalFirst-page size, up to 10,000

profoundmcp_get_citations_report#See which sources AI engines cite for a category, and how often, over a date range.18 params▾

See which sources AI engines cite for a category, and how often, over a date range.

NameTypeRequiredDescription

category_idstringrequiredCategory to report on

end_datestringrequiredWindow end in YYYY-MM-DD format (exclusive)

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

start_datestringrequiredWindow start in YYYY-MM-DD format (inclusive)

citation_category_filterarrayoptionalNarrow to specific citation categories

cursorstringoptionalPagination token

dimensionsarrayoptionalGroup-by fields

filtersarrayoptionalAdvanced predicates

hostname_filterarrayoptionalNarrow to specific hostnames

limitintegeroptionalTop-N row cap

metricsarrayoptionalMetrics to return

model_filterarrayoptionalNarrow to specific AI models

page_sizeintegeroptionalFirst-page size, up to 10,000

persona_filterarrayoptionalNarrow to specific personas

region_filterarrayoptionalNarrow to specific regions

root_domain_filterarrayoptionalNarrow to specific root domains

tag_filterarrayoptionalNarrow to specific tags

topic_filterarrayoptionalNarrow to specific topics

profoundmcp_get_prompt_answers#Retrieve the actual answers AI engines gave for a category's prompts over a date range.6 params▾

Retrieve the actual answers AI engines gave for a category's prompts over a date range.

NameTypeRequiredDescription

category_idstringrequiredCategory to retrieve answers for

end_datestringrequiredWindow end in YYYY-MM-DD format (exclusive)

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

start_datestringrequiredWindow start in YYYY-MM-DD format (inclusive)

limitintegeroptionalRows per page

offsetintegeroptionalRow offset for pagination

profoundmcp_get_referrals_report#Measure visits a domain received from AI engines, such as ChatGPT and Perplexity, over a date range.13 params▾

Measure visits a domain received from AI engines, such as ChatGPT and Perplexity, over a date range.

NameTypeRequiredDescription

domainstringrequiredTracked domain using exact hostname from list_domains

end_datestringrequiredWindow end in YYYY-MM-DD format (exclusive)

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

start_datestringrequiredWindow start in YYYY-MM-DD format (inclusive)

cursorstringoptionalPagination token

dimensionsarrayoptionalGroup-by fields

filtersarrayoptionalAdvanced predicates

limitintegeroptionalTop-N row cap

metricsarrayoptionalMetrics to return

organization_idstringoptionalDisambiguate domain across organizations

page_sizeintegeroptionalFirst-page size, up to 10,000

referral_source_filterarrayoptionalNarrow to specific referrer vendors

referral_type_filterarrayoptionalNarrow to referral categories

profoundmcp_get_sentiment_report#Measure sentiment in AI answers for a category over a date range. Default metrics: positive, negative, and occurrences.16 params▾

Measure sentiment in AI answers for a category over a date range. Default metrics: positive, negative, and occurrences.

NameTypeRequiredDescription

category_idstringrequiredCategory to report on

end_datestringrequiredWindow end in YYYY-MM-DD format (exclusive)

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

start_datestringrequiredWindow start in YYYY-MM-DD format (inclusive)

asset_filterarrayoptionalNarrow to brand/competitor assets

cursorstringoptionalPagination token

filtersarrayoptionalAdvanced predicates

limitintegeroptionalTop-N row cap

metricsarrayoptionalMetrics to return

model_filterarrayoptionalNarrow to specific AI models

page_sizeintegeroptionalFirst-page size, up to 10,000

persona_filterarrayoptionalNarrow to specific personas

region_filterarrayoptionalNarrow to specific regions

tag_filterarrayoptionalNarrow to specific tags

theme_filterarrayoptionalNarrow to specific sentiment themes

topic_filterarrayoptionalNarrow to specific topics

profoundmcp_get_visibility_report#Measure how often and how prominently a brand appears in AI answers for a category over a date range.16 params▾

Measure how often and how prominently a brand appears in AI answers for a category over a date range.

NameTypeRequiredDescription

category_idstringrequiredCategory to report on

end_datestringrequiredWindow end in YYYY-MM-DD format (exclusive)

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

start_datestringrequiredWindow start in YYYY-MM-DD format (inclusive)

asset_filterarrayoptionalNarrow to brand/competitor assets

cursorstringoptionalPagination token

dimensionsarrayoptionalGroup-by fields

filtersarrayoptionalAdvanced predicates with field, operator, value

limitintegeroptionalTop-N row cap

metricsarrayoptionalMetrics to return

model_filterarrayoptionalNarrow to specific AI models

page_sizeintegeroptionalFirst-page size, up to 10,000

persona_filterarrayoptionalNarrow to specific personas

region_filterarrayoptionalNarrow to specific regions

tag_filterarrayoptionalNarrow to specific tags

topic_filterarrayoptionalNarrow to specific topics

profoundmcp_list_categories#List tracked categories, markets, or segments in an organization. Most brand visibility reports are scoped to a category.2 params▾

List tracked categories, markets, or segments in an organization. Most brand visibility reports are scoped to a category.

NameTypeRequiredDescription

org_idstringrequiredOrganization whose categories to list

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

profoundmcp_list_domains#List tracked domains for an organization. Domains are exact hostnames, so www.example.com and example.com are distinct.2 params▾

List tracked domains for an organization. Domains are exact hostnames, so www.example.com and example.com are distinct.

NameTypeRequiredDescription

org_idstringrequiredOrganization whose tracked domains to list

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

profoundmcp_list_models#List the AI models Profound tracks. Use returned model IDs to filter reports to a single engine.1 param▾

List the AI models Profound tracks. Use returned model IDs to filter reports to a single engine.

NameTypeRequiredDescription

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

profoundmcp_list_organizations#List the organizations the authenticated user can access. Returned IDs feed category, domain, and report tools.1 param▾

List the organizations the authenticated user can access. Returned IDs feed category, domain, and report tools.

NameTypeRequiredDescription

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

profoundmcp_list_prompts#List prompts configured in a category. Prompts are the questions Profound runs against AI engines to measure brand visibility.10 params▾

List prompts configured in a category. Prompts are the questions Profound runs against AI engines to measure brand visibility.

NameTypeRequiredDescription

category_idstringrequiredCategory to list prompts for

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

combinestringoptionalHow include filters combine

cursorstringoptionalPagination token from previous response

exclude_tag_idsarrayoptionalExclude prompts carrying these tags

exclude_topic_idsarrayoptionalExclude prompts under these topics

limitintegeroptionalMaximum prompts to return

statusstringoptionalFilter by prompt status

tag_idsarrayoptionalInclude only prompts carrying these tags

topic_idsarrayoptionalInclude only prompts under these topics

profoundmcp_list_regions#List geographic regions configured for an organization. Omit org_id to see regions across all accessible organizations.2 params▾

List geographic regions configured for an organization. Omit org_id to see regions across all accessible organizations.

NameTypeRequiredDescription

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

org_idstringoptionalOrganization identifier

profoundmcp_list_tags#List tags available within a category for filtering prompts and reports.2 params▾

List tags available within a category for filtering prompts and reports.

NameTypeRequiredDescription

category_idstringrequiredCategory whose tags to list

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

profoundmcp_list_topics#List topics available within a category for filtering prompts and reports.2 params▾

List topics available within a category for filtering prompts and reports.

NameTypeRequiredDescription

category_idstringrequiredCategory to list topics for

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool

profoundmcp_whoami#Confirm the authenticated user, organizations, regions, and entitlements available to this MCP session.1 param▾

Confirm the authenticated user, organizations, regions, and entitlements available to this MCP session.

NameTypeRequiredDescription

rationalestringrequiredAlways provide a brief explanation of why you are calling this tool