Connect AI agents to the Revealed AI MCP server

Vendor MCP

The Revealed AI MCP connector routes your AI agent's tool calls to Revealed AI's own MCP server through Scalekit. Each user signs in to Revealed AI once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 13 tools.

Tools: 13
What they doRead · write · destructive: 13 · 0 · 013 read0 write0 destructive
Users sign in with: OAuth
OAuth app: Scalekit's or your own

What you can do

Review accounts: list accounts and pull full snapshots or compact briefs with company signals and summaries
Track buying signals: see recent changes, person changes, and signal events since the last snapshot
Research people: list people and buyer personas at an account and open their full profiles
Get next best actions: retrieve ranked outreach actions with target, rationale, and a draft message

Setup

Install the SDK
- Node.js
- Python
Terminal window
npm install @scalekit-sdk/node dotenv
Terminal window
pip install scalekit-sdk-python python-dotenv
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>
```
Create the Revealed AI MCP connection
In AgentKit > Connections, create a Revealed AI MCP connection. The name you give it is the connection_name your code passes. See Configure connections.
Scalekit credentials are available for Revealed AI MCP server, so you don't need to register an OAuth app.

Authorize a user and make your first call

Node.js
Python

1
import { ScalekitClient } from '@scalekit-sdk/node'
2
import 'dotenv/config'
3
import { createInterface } from 'node:readline/promises'
4

5
const scalekit = new ScalekitClient(
6
  process.env.SCALEKIT_ENVIRONMENT_URL,
7
  process.env.SCALEKIT_CLIENT_ID,
8
  process.env.SCALEKIT_CLIENT_SECRET,
9
)
10
const actions = scalekit.actions
11

12
const connector = 'revealedaimcp'
13
const identifier = 'user_123'
14

15
// Generate an authorization link for the user
16
const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
17
console.log('Authorize Revealed AI MCP:', link)
18
const rl = createInterface({ input: process.stdin, output: process.stdout })
19
await rl.question('Press Enter after authorizing...')
20
rl.close()
21

22
// Make your first call
23
const result = await actions.executeTool({
24
  connector,
25
  identifier,
26
  toolName: 'revealedaimcp_list_accounts',
27
  toolInput: {},
28
})
29
console.log(result)

npx tsx quickstart.mts

1
import os
2
from scalekit import ScalekitClient
3
from dotenv import load_dotenv
4
load_dotenv()
5

6
scalekit_client = ScalekitClient(
7
    env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
8
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
9
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
10
)
11
actions = scalekit_client.actions
12

13
connection_name = "revealedaimcp"
14
identifier = "user_123"
15

16
# Generate an authorization link for the user
17
link_response = actions.get_authorization_link(
18
    connection_name=connection_name,
19
    identifier=identifier,
20
)
21
print("Authorize Revealed AI MCP:", link_response.link)
22
input("Press Enter after authorizing...")
23

24
# Make your first call
25
result = actions.execute_tool(
26
    tool_input={},
27
    tool_name="revealedaimcp_list_accounts",
28
    connection_name=connection_name,
29
    identifier=identifier,
30
)
31
print(result)

python quickstart.py

Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool

Try in Playground Request a tool

revealedaimcp_get_accountRetrieve the full account snapshot including company signals, people, summaries, and metadata.Read-only
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.
Inputs
account_idstringrequired
Account UUID from list_accounts. Obtain by calling List Accounts first.
revealedaimcp_get_account_briefRetrieve a compact account overview from the latest snapshot including change summary, signal counts, and top signals by impact.Read-only
Get Account Brief
Retrieve a compact account overview from the latest snapshot including change summary, signal counts, and top signals by impact.
Inputs
account_idstringrequired
Account UUID from list_accounts. Obtain by calling List Accounts first.
revealedaimcp_get_company_signalRetrieve all snapshot rows for a specific company signal by its data element slug.Read-only
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.
Inputs
account_idstringrequired
Account UUID from list_accounts. Obtain by calling List Accounts first.
signal_slugstringrequired
Data element slug for the company signal. Obtain from List Tracked Signals.
revealedaimcp_get_personRetrieve the full person record from the latest snapshot.Read-only
Get Person
Retrieve the full person record from the latest snapshot. Provide exactly one of persona (slug), name (full name), or person_id.
Inputs
account_idstringrequired
Account UUID from list_accounts. Obtain by calling List Accounts first.
namestring
Person's full name as shown in List People. Merges all persona rows for that person. Mutually exclusive with persona.
person_idstring
Deprecated alias for persona slug. Use persona or name instead.
personastring
Persona slug (e.g. chief-nursing-officer). Obtain from List Personas or List People.
revealedaimcp_list_accountsList accounts in the workspace with lifecycle status and last reviewed date.Read-only
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.
Inputs
limitinteger
Maximum number of items to return.default 50
querystring
Case-insensitive substring to filter account names.
statusstring
Lifecycle status filter. Accepted values: active, paused, all.default active
revealedaimcp_list_peopleList people at an account from the latest snapshot, deduplicated by name.Read-only
List People
List people at an account from the latest snapshot, deduplicated by name. Optionally filter by persona slug substring or change type.
Inputs
account_idstringrequired
Account UUID from list_accounts. Obtain by calling List Accounts first.
change_typestring
Filter people by their latest change type. Accepted values: new, departed, role_change, any.default any
limitinteger
Maximum number of items to return.default 50
personastring
Persona slug (e.g. chief-nursing-officer). Obtain from List Personas or List People.
revealedaimcp_list_personasList buyer persona slugs present in an account snapshot with counts and human-readable names.Read-only
List Personas
List buyer persona slugs present in an account snapshot with counts and human-readable names. Use slugs with Get Person.
Inputs
account_idstringrequired
Account UUID from list_accounts. Obtain by calling List Accounts first.
revealedaimcp_list_tracked_signalsList persona slugs, people signal slugs, and company signal slugs configured for this workspace.Read-only
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.
Inputs
This tool takes no inputs.
revealedaimcp_mcp_statusCheck MCP connectivity and return workspace name, OAuth client ID, and granted token scopes.Read-only
Mcp Status
Check MCP connectivity and return workspace name, OAuth client ID, and granted token scopes. Call after connecting to verify the session.
Inputs
This tool takes no inputs.
revealedaimcp_plan_usageRetrieve billing plan limits and current account usage counts for the workspace.Read-only
Plan Usage
Retrieve billing plan limits and current account usage counts for the workspace. Requires admin:read scope.
Inputs
This tool takes no inputs.
revealedaimcp_recent_changesRetrieve what changed since the last finalized snapshot: change summary, person changes, and signal events.Read-only
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.
Inputs
account_idstringrequired
Account UUID from list_accounts. Obtain by calling List Accounts first.
limitinteger
Maximum number of items to return.default 20
sincestring
Reserved for future time filtering. Currently unused.
revealedaimcp_recommended_actionsRetrieve outreach-oriented actions derived from person changes and signal events, including target, rationale, and a draft message.Read-only
Recommended Actions
Retrieve outreach-oriented actions derived from person changes and signal events, including target, rationale, and a draft message.
Inputs
account_idstringrequired
Account UUID from list_accounts. Obtain by calling List Accounts first.
limitinteger
Maximum number of items to return.default 10
person_idstring
Deprecated alias for persona slug. Use persona or name instead.
personastring
Persona slug (e.g. chief-nursing-officer). Obtain from List Personas or List People.
revealedaimcp_top_actionsRetrieve ranked recommended actions across all active accounts in the workspace.Read-only
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.
Inputs
limitinteger
Maximum number of items to return.default 15

Connect AI agents to the Revealed AI MCP server

What you can do

Setup

Install the SDK

Set your credentials

Create the Revealed AI MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Get Account

Inputs

Get Account Brief

Inputs

Get Company Signal

Inputs

Get Person

Inputs

List Accounts

Inputs

List People

Inputs

List Personas

Inputs

List Tracked Signals

Inputs

Mcp Status

Inputs

Plan Usage

Inputs

Recent Changes

Inputs

Recommended Actions

Inputs

Top Actions

Inputs

What you can do

Setup

Install the SDK

Set your credentials

Create the Revealed AI MCP connection

Authorize a user and make your first call

Tools

Call it

Returns

Get Account

Inputs

Get Account Brief

Inputs

Get Company Signal

Inputs

Get Person

Inputs

List Accounts

Inputs

List People

Inputs

List Personas

Inputs

List Tracked Signals

Inputs

Mcp Status

Inputs

Plan Usage

Inputs

Recent Changes

Inputs

Recommended Actions

Inputs

Top Actions

Inputs

Related: other CRM & Sales connectors