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

What you can do

Connect this agent connector to let your agent:

• Actions top, recommended — Retrieve ranked recommended actions across all active accounts in the workspace
• Changes recent — Retrieve what changed since the last finalized snapshot: change summary, person changes, and signal events
• Usage plan — Retrieve billing plan limits and current account usage counts for the workspace
• Status mcp — Check MCP connectivity and return workspace name, OAuth client ID, and granted token scopes
• List tracked signals, personas, people — List persona slugs, people signal slugs, and company signal slugs configured for this workspace
• Get person, company signal, account brief — Retrieve the full person record from the latest snapshot

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.

revealedaimcp_get_account # Retrieve the full account snapshot including company signals, people, summaries, and metadata. Use Get Account Brief for lightweight overviews when scanning many accounts. 1 param ▾

Retrieve the full account snapshot including company signals, people, summaries, and metadata. Use Get Account Brief for lightweight overviews when scanning many accounts.

Name Type Required Description

account_id string required Account UUID from list_accounts. Obtain by calling List Accounts first.

revealedaimcp_get_account_brief # Retrieve a compact account overview from the latest snapshot including change summary, signal counts, and top signals by impact. 1 param ▾

Retrieve a compact account overview from the latest snapshot including change summary, signal counts, and top signals by impact.

Name Type Required Description

account_id string required Account UUID from list_accounts. Obtain by calling List Accounts first.

revealedaimcp_get_company_signal # Retrieve all snapshot rows for a specific company signal by its data element slug. Use List Tracked Signals to discover available signal slugs. 2 params ▾

Retrieve all snapshot rows for a specific company signal by its data element slug. Use List Tracked Signals to discover available signal slugs.

Name Type Required Description

account_id string required Account UUID from list_accounts. Obtain by calling List Accounts first.

signal_slug string required Data element slug for the company signal. Obtain from List Tracked Signals.

revealedaimcp_get_person # Retrieve the full person record from the latest snapshot. Provide exactly one of persona (slug), name (full name), or person_id. 4 params ▾

Retrieve the full person record from the latest snapshot. Provide exactly one of persona (slug), name (full name), or person_id.

Name Type Required Description

account_id string required Account UUID from list_accounts. Obtain by calling List Accounts first.

name string optional Person's full name as shown in List People. Merges all persona rows for that person. Mutually exclusive with persona.

person_id string optional Deprecated alias for persona slug. Use persona or name instead.

persona string optional Persona slug (e.g. chief-nursing-officer). Obtain from List Personas or List People.

revealedaimcp_list_accounts # List accounts in the workspace with lifecycle status and last reviewed date. Call this first to obtain account IDs required by all other account-scoped tools. 3 params ▾

List accounts in the workspace with lifecycle status and last reviewed date. Call this first to obtain account IDs required by all other account-scoped tools.

Name Type Required Description

limit integer optional Maximum number of items to return.

query string optional Case-insensitive substring to filter account names.

status string optional Lifecycle status filter. Accepted values: active, paused, all.

revealedaimcp_list_people # List people at an account from the latest snapshot, deduplicated by name. Optionally filter by persona slug substring or change type. 4 params ▾

List people at an account from the latest snapshot, deduplicated by name. Optionally filter by persona slug substring or change type.

Name Type Required Description

account_id string required Account UUID from list_accounts. Obtain by calling List Accounts first.

change_type string optional Filter people by their latest change type. Accepted values: new, departed, role_change, any.

limit integer optional Maximum number of items to return.

persona string optional Persona slug (e.g. chief-nursing-officer). Obtain from List Personas or List People.

revealedaimcp_list_personas # List buyer persona slugs present in an account snapshot with counts and human-readable names. Use slugs with Get Person. 1 param ▾

List buyer persona slugs present in an account snapshot with counts and human-readable names. Use slugs with Get Person.

Name Type Required Description

account_id string required Account UUID from list_accounts. Obtain by calling List Accounts first.

revealedaimcp_list_tracked_signals # List persona slugs, people signal slugs, and company signal slugs configured for this workspace. Use these slugs with Get Person and Get Company Signal. 0 params ▾

List persona slugs, people signal slugs, and company signal slugs configured for this workspace. Use these slugs with Get Person and Get Company Signal.

revealedaimcp_mcp_status # Check MCP connectivity and return workspace name, OAuth client ID, and granted token scopes. Call after connecting to verify the session. 0 params ▾

Check MCP connectivity and return workspace name, OAuth client ID, and granted token scopes. Call after connecting to verify the session.

revealedaimcp_plan_usage # Retrieve billing plan limits and current account usage counts for the workspace. Requires admin:read scope. 0 params ▾

Retrieve billing plan limits and current account usage counts for the workspace. Requires admin:read scope.

revealedaimcp_recent_changes # Retrieve what changed since the last finalized snapshot: change summary, person changes, and signal events. Use for meeting prep and what-is-new questions. 3 params ▾

Retrieve what changed since the last finalized snapshot: change summary, person changes, and signal events. Use for meeting prep and what-is-new questions.

Name Type Required Description

account_id string required Account UUID from list_accounts. Obtain by calling List Accounts first.

limit integer optional Maximum number of items to return.

since string optional Reserved for future time filtering. Currently unused.

revealedaimcp_recommended_actions # Retrieve outreach-oriented actions derived from person changes and signal events, including target, rationale, and a draft message. 4 params ▾

Retrieve outreach-oriented actions derived from person changes and signal events, including target, rationale, and a draft message.

Name Type Required Description

account_id string required Account UUID from list_accounts. Obtain by calling List Accounts first.

limit integer optional Maximum number of items to return.

person_id string optional Deprecated alias for persona slug. Use persona or name instead.

persona string optional Persona slug (e.g. chief-nursing-officer). Obtain from List Personas or List People.

revealedaimcp_top_actions # Retrieve ranked recommended actions across all active accounts in the workspace. Use when the user asks for next steps without specifying an account. 1 param ▾

Retrieve ranked recommended actions across all active accounts in the workspace. Use when the user asks for next steps without specifying an account.

Name Type Required Description

limit integer optional Maximum number of items to return.