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

What you can do

Connect this agent connector to let your agent:

• Search recording transcripts, emails, deals — Perform keyword or semantic search on the recording transcript database, with optional filters on the recording metadata
• List workspaces, recording views, emails — List all Claap workspaces the user has access to
• Get recordings, recording view, recording transcript — Query the recording metadata database with a set of filters

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.

claapmcp_get_email#Fetch the full email content including the body for a given message ID from the workspace.2 params▾

Fetch the full email content including the body for a given message ID from the workspace.

NameTypeRequiredDescription

messageIdstringrequiredThe email message ID to fetch.

workspaceIdstringrequiredThe Claap workspace ID the email belongs to.

claapmcp_get_recording_transcript#Fetch the full transcript for a given recording.2 params▾

Fetch the full transcript for a given recording.

NameTypeRequiredDescription

recordingIdstringrequiredThe ID of the recording to get the transcript for.

workspaceIdstringrequiredThe Claap workspace ID the recording belongs to.

claapmcp_get_recording_view#Fetch the rows of a Claap recording view: each row is a recording matching the view filters, with AI-generated insight values for each of the view columns. Workspaces define their own views (common examples: MEDDIC/SPICED qualification, hiring rubrics, objection trackers). Discover available views via list_recording_views.4 params▾

Fetch the rows of a Claap recording view: each row is a recording matching the view filters, with AI-generated insight values for each of the view columns. Workspaces define their own views (common examples: MEDDIC/SPICED qualification, hiring rubrics, objection trackers). Discover available views via list_recording_views.

NameTypeRequiredDescription

viewIdstringrequiredThe ID of the recording view to fetch rows for.

workspaceIdstringrequiredThe Claap workspace ID the view belongs to.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

claapmcp_get_recordings#Query the recording metadata database with a set of filters. Returns a collection of recording metadata ordered by relevance and creation date descending.5 params▾

Query the recording metadata database with a set of filters. Returns a collection of recording metadata ordered by relevance and creation date descending.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to query recordings from.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

filtersobjectoptionalFilters to apply to the recording query.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

sortarrayoptionalSort dimensions. When omitted, results are ordered by relevance and creation date descending.

claapmcp_list_emails#List emails across the workspace with metadata (sender, recipients, subject, sent date). Supports filtering by contact, company, deal, or thread. Results are sorted by sent date.9 params▾

List emails across the workspace with metadata (sender, recipients, subject, sent date). Supports filtering by contact, company, deal, or thread. Results are sorted by sent date.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to list emails from.

companyIdstringoptionalFilter by company ID.

contactIdstringoptionalFilter by contact ID (sender or recipient).

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

dealIdstringoptionalFilter by deal ID.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

sortBystringoptionalSort field. Defaults to sentAt.

sortOrderstringoptionalSort order. Defaults to desc (most recent first).

threadIdstringoptionalFilter by email thread ID.

claapmcp_list_recording_views#List the recording views configured in a Claap workspace. A view is a curated set of recordings enriched with AI-generated insight columns. Common examples include sales qualification frameworks (MEDDIC, SPICED, BANT), hiring rubrics, and objection trackers. Prefer views over get_recordings when a view matches the user question. Use get_recording_view to read a specific view's rows.1 param▾

List the recording views configured in a Claap workspace. A view is a curated set of recordings enriched with AI-generated insight columns. Common examples include sales qualification frameworks (MEDDIC, SPICED, BANT), hiring rubrics, and objection trackers. Prefer views over get_recordings when a view matches the user question. Use get_recording_view to read a specific view's rows.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to list recording views from.

claapmcp_list_workspaces#List all Claap workspaces the user has access to.0 params▾

List all Claap workspaces the user has access to.

claapmcp_search_companies#Search the Claap company database.5 params▾

Search the Claap company database.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to search within.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

namestringoptionalComplete or partial name or domain of the company to search for.

sortarrayoptionalSort dimensions to apply to the search results.

claapmcp_search_contacts#Search the Claap contact database. Returns both workspace users and external contacts.5 params▾

Search the Claap contact database. Returns both workspace users and external contacts.

NameTypeRequiredDescription

workspaceIdstringrequiredThe Claap workspace ID to search within.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

querystringoptionalComplete or partial name, email or domain of the contact to search for.

sortarrayoptionalSort dimensions to apply to the search results. When omitted, results are ordered by relevance.

claapmcp_search_deals#Search the Claap deal database with filters and sorting options.5 params▾

Search the Claap deal database with filters and sorting options.

NameTypeRequiredDescription

filtersobjectrequiredFilters to apply to the search.

workspaceIdstringrequiredThe Claap workspace ID to search within.

cursorstringoptionalOpaque cursor returned as nextCursor by a previous call. Pass verbatim to fetch the next page.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

sortarrayoptionalSort dimensions to apply to the search results.

claapmcp_search_emails#Search email content using semantic or keyword search across the workspace. Returns results as chunks with text snippets and metadata. Multiple results can be related to the same email (different chunks from the same message). Supports filtering by contact, company, or deal.7 params▾

Search email content using semantic or keyword search across the workspace. Returns results as chunks with text snippets and metadata. Multiple results can be related to the same email (different chunks from the same message). Supports filtering by contact, company, or deal.

NameTypeRequiredDescription

searchobjectrequiredSearch query and technique.

workspaceIdstringrequiredThe Claap workspace ID to search within.

companyIdstringoptionalFilter by company ID.

contactIdstringoptionalFilter by contact ID (sender or recipient).

cursorstringoptionalOpaque cursor for keyword search pagination. Not supported for semantic search.

dealIdstringoptionalFilter by deal ID.

limitnumberoptionalMaximum number of results per page (default 10, max 100).

claapmcp_search_recording_transcripts#Perform keyword or semantic search on the recording transcript database, with optional filters on the recording metadata. Returns a collection of transcript chunks grouped by recording.5 params▾

Perform keyword or semantic search on the recording transcript database, with optional filters on the recording metadata. Returns a collection of transcript chunks grouped by recording.

NameTypeRequiredDescription

searchobjectrequiredSearch query and technique.

workspaceIdstringrequiredThe Claap workspace ID to search within.

cursorstringoptionalOpaque cursor for keyword search pagination. Not supported for semantic search.

filtersobjectoptionalFilters to apply to the search.

limitnumberoptionalMaximum number of results per page (default 10, max 100).