Salespeak MCP Server

Model Context Protocol server for AI-powered sales intelligence, analytics, and knowledge base management.

Use Cases

Connect your MCP client (Claude Desktop, ChatGPT, Cursor, or any MCP-compatible app) and use natural language to access your sales data.

Getting Started

Add this server to any MCP-compatible client. The server uses OAuth 2.1 for authentication—your client will handle the login flow automatically.

MCP Client Configuration

Add the following to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "salespeak": {
      "url": "https://platform.salespeak.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

How Authentication Works

The /mcp endpoint requires a valid Bearer token. When your MCP client connects, it will:

1. Discover OAuth metadata via /.well-known/oauth-authorization-server
2. Register itself as a client via /oauth/register (Dynamic Client Registration)
3. Redirect you to the Salespeak login page
4. Exchange the authorization code for tokens
5. Attach the Bearer token to all subsequent MCP requests

OAuth Setup

If you are building a custom MCP client or integration, follow these steps to authenticate.

POST /oauth/register
Content-Type: application/json

{
  "client_name": "My MCP Client",
  "redirect_uris": ["https://myapp.example.com/callback"],
  "grant_types": ["authorization_code", "refresh_token"],
  "response_types": ["code"],
  "token_endpoint_auth_method": "client_secret_basic"
}

GET /oauth/authorize?
  client_id=YOUR_CLIENT_ID&
  redirect_uri=https://myapp.example.com/callback&
  state=RANDOM_STATE&
  code_challenge=BASE64URL_SHA256_CHALLENGE&
  code_challenge_method=S256&
  scope=openid profile email

POST /oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&
code=AUTHORIZATION_CODE&
code_verifier=ORIGINAL_CODE_VERIFIER&
client_id=YOUR_CLIENT_ID

{
  "access_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "eyJ..."
}

Authorization: Bearer eyJ...

Company Context MCP

A second, read-only endpoint for agents that need to get your company right: your own assistants, a customer-facing bot, a workflow. It has one tool, ask_semantic_layer, and answers only from your knowledge bank.

https://platform.salespeak.ai/gtm-context/mcp

Connect with a signed-in user (OAuth)

Add the URL to an MCP client such as Claude or ChatGPT. The client discovers OAuth from the endpoint, and you sign in with your Salespeak account. Answers come from the organization you belong to.

claude mcp add --transport http salespeak https://platform.salespeak.ai/gtm-context/mcp

Connect an agent with an API key

For an agent that runs with no one signed in, create a key in the Salespeak app (Publish → API keys) and send it as a Bearer token. A key belongs to one organization, can only read, and works on this endpoint only. It is shown once when you create it. Revoking it takes effect within 30 seconds.

claude mcp add --transport http salespeak https://platform.salespeak.ai/gtm-context/mcp   --header "Authorization: Bearer spk_..."

Tools Reference

The authenticated /mcp endpoint exposes 10 tools. All tools automatically resolve the caller's organization from the OAuth token.

Support