The Sprouts MCP Server provides AI assistants with powerful prospect intelligence tools through the Model Context Protocol. Built on Cloudflare Workers, it offers secure OAuth authentication, persistent storage, and advanced search capabilities across 35+ million company profiles.

Production Server URL: https://sprouts-mcp-server.kartikay-dhar.workers.dev

OAuth 2.0 Flow

The server implements industry-standard OAuth 2.0 authentication

Discovery Endpoint

GET /.well-known/oauth-protected-resource

Response:

json

{

"resource": "https://sprouts-mcp-server.kartikay-dhar.workers.dev",

"authorization_servers": ["https://sprouts.scalekit.dev/resources/res_107781942316893193"],

"bearer_methods_supported": ["header"],

"scopes_supported": ["mcp:read", "mcp:write"],

"resource_name": "Sprouts AI MCP Server"

}

Authentication Process

Claude Desktop Configuration

Add to your claude_desktop_config.json:

json

{

"mcpServers": {

"sprouts-ai": {

"command": "npx",

"args": [

"mcp-remote",

"https://sprouts-mcp-server.kartikay-dhar.workers.dev/sse"

]

}

}

}

ℹ️ Note: The MCP client automatically handles OAuth authentication flow

Purpose: Search for prospects using natural language queries with advanced AI-powered analysis

Parameters

Example: Basic Search

json

{

"jsonrpc": "2.0",

"method": "tools/call",

"params": {

"name": "sprouts_data_intelligence",

"arguments": {

"query": "find VP of Sales at SaaS companies in San Francisco with 50-200 employees",

"pageSize": 10

}

},

"id": "1"

}

Purpose: Transfer contacts or accounts from search results to your Sprouts platform

Parameters

⚠️ Important: Use contact_id for contacts and account_id for accounts (32-character hex strings)

Example: Move Contacts

json

{

"jsonrpc": "2.0",

"method": "tools/call",

"params": {

"name": "move_to_sprouts",

"arguments": {

"type": "contacts",

"ids": [

"140e2602efcc47c191bda2b85e20fad5",

"3e64d01b4d194d2f8153039171302cc9"

]

}

},

"id": "4"

}

Purpose: Create and manage reusable search templates with variables

Available Actions

Example: Create Template

json

{

"jsonrpc": "2.0",

"method": "tools/call",

"params": {

"name": "query_templates",

"arguments": {

"action": "create",

"template": {

"name": "Enterprise Decision Makers",

"description": "Find C-level executives at enterprise companies",

"template": "find {title} at {industry} companies with more than {employee_count} employees in {location}",

"variables": [

{"name": "title", "default": "CTO"},

{"name": "industry", "default": "technology"},

{"name": "employee_count", "default": "1000"},

{"name": "location", "default": "United States"}

],

"category": "enterprise"

}

}

},

"id": "6"

}

Purpose: AI-powered query analysis and optimization suggestions

Available Actions

Refinement Categories

Purpose: Track, analyze, and learn from search patterns

Available Actions

Example: Get Analytics

json

{

"jsonrpc": "2.0",

"method": "tools/call",

"params": {

"name": "search_history",

"arguments": {

"action": "analytics",

"dateFrom": "2025-01-01T00:00:00Z",

"dateTo": "2025-01-14T23:59:59Z"

}

},

"id": "7"

}

Purpose: Ideal Customer Profile management and prospect analysis

Available Actions

Analysis Types

Example: Setup ICP

json

{

"jsonrpc": "2.0",

"method": "tools/call",

"params": {

"name": "icp_analysis",

"arguments": {

"action": "setup",

"companyInfo": {

"name": "Acme Corp",

"industry": "B2B SaaS",

"description": "Enterprise sales automation platform",

"targetIndustries": ["Technology", "Financial Services", "Healthcare"],

"targetCompanySizes": ["mid-size", "large", "enterprise"],

"targetJobTitles": ["VP Sales", "CRO", "Head of Revenue"],

"targetSeniority": ["senior", "executive"],

"targetLocations": ["United States", "United Kingdom", "Canada"]

}

}

},

"id": "5"

}

Purpose: Configure personal preferences for optimized searches

Available Actions

Available Field Sets

Perform complex searches using Boolean operators:

json

{

"query": "(Marketing Manager OR Growth Lead) AND SaaS NOT agency",

"booleanQuery": {

"enabled": true,

"parseComplexQueries": true

}

}

Track prospect career progression and readiness:

json

{

"careerPath": {

"enabled": true,

"includeProgression": true,

"includeReadiness": true

}

}

json

{

"clustering": {

"enabled": true,

"strategy": "industry_focused", // or "geographic", "seniority_levels"

"maxClusters": 10,

"minClusterSize": 3

}

}

Identify key decision makers with AI scoring:

json

{

"decisionMaker": {

"industry": "fintech",

"companySize": "startup",

"saleType": "enterprise",

"solution": "software"

}

}

Optimize token usage and response size:

json

{

"fieldSelection": {

"fieldSet": "sales_outreach",

"excludeHighVolume": true,

"responseMode": "data",

"maxEstimatedTokens": 5000

}

}

Example 1: Enterprise Sales Prospecting

Scenario: Find CTOs at Series A fintech startups in New York

json

{

"jsonrpc": "2.0",

"method": "tools/call",

"params": {

"name": "sprouts_data_intelligence",

"arguments": {

"query": "CTO or VP Engineering at fintech startups in New York that raised Series A",

"pageSize": 25,

"ranking": {

"targetCompanySize": "startup",

"targetIndustry": "fintech",

"targetSeniority": "executive",

"boostKeywords": ["AI", "machine learning", "blockchain"]

},

"decisionMaker": {

"industry": "fintech",

"companySize": "startup",

"saleType": "enterprise",

"solution": "software"

},

"clustering": {

"enabled": true,

"strategy": "seniority_levels"

}

}

},

"id": "2"

}

Example 2: Boolean Search with Field Optimization

Scenario: Find marketing leaders at SaaS companies (excluding agencies)

json

{

"jsonrpc": "2.0",

"method": "tools/call",

"params": {

"name": "sprouts_data_intelligence",

"arguments": {

"query": "(Marketing Manager OR Growth Lead) AND SaaS NOT agency",

"pageSize": 50,

"booleanQuery": {

"enabled": true,

"parseComplexQueries": true

},

"fieldSelection": {

"fieldSet": "sales_outreach",

"excludeHighVolume": true

}

}

},

"id": "3"

}

Example 3: Complete Workflow - Search, Analyze, and Import

Step 1: Search for prospects

json

{

"name": "sprouts_data_intelligence",

"arguments": {

"query": "VP of Sales at e-commerce companies in California",

"pageSize": 20

}

}

Step 2: Move qualified leads to Sprouts

json

{

"name": "move_to_sprouts",

"arguments": {

"type": "contacts",

"ids": ["140e2602efcc47c191bda2b85e20fad5", "3e64d01b4d194d2f8153039171302cc9"]

}

}

Step 3: Analyze search patterns

json

{

"name": "search_history",

"arguments": {

"action": "patterns"

}

}

Standard Error Format

json

{

"jsonrpc": "2.0",

"id": "1",

"error": {

"code": -32600,

"message": "Invalid request format"

}

}

Error Code Reference

Authentication Error Example

json

{

"jsonrpc": "2.0",

"id": null,

"error": {

"code": -32001,

"message": "Authentication required: Missing Authorization header"

}

}

Issue: 401 Unauthorized Error

Symptoms: Requests fail with authentication error

Possible Causes:

Solutions:

Issue: Empty Search Results

Symptoms: Query returns zero results

Possible Causes:

Solutions:

json

{

"queryHandling": {

"allowTimeExpansion": true,

"allowNumberExpansion": true,

"expansionStrategy": "moderate"

}

}

Issue: Invalid Tool Name Error

Symptoms: -32601 Method not found error

Possible Causes:

Solutions: Use exact tool names:

Issue: Move Operation Fails

Symptoms: move_to_sprouts returns error

Possible Causes:

Solutions:

Local Development Setup

bash

# Clone repository

git clone https://github.com/sprouts-ai/mcp-server.git

cd mcp-server

# Install dependencies

npm install

# Run development server

npm run dev

# Run tests

npm test

# Deploy to production

npm run deploy

Environment Configuration

Required Secrets

Configure via wrangler.toml or using Wrangler CLI:

bash

# OAuth Configuration (Scalekit)

wrangler secret put SCALEKIT_ENVIRONMENT_URL

wrangler secret put SCALEKIT_CLIENT_ID

wrangler secret put SCALEKIT_CLIENT_SECRET

wrangler secret put SCALEKIT_RESOURCE_ID

# Sprouts API Configuration

wrangler secret put SPROUTS_API_KEY

wrangler secret put SPROUTS_API_SECRET

# Move to Sprouts Configuration

wrangler secret put MOVE_TO_SPROUTS_TOKEN

wrangler secret put MOVE_TO_SPROUTS_EMAIL

wrangler secret put MOVE_TO_SPROUTS_CUSTOMER_ID

Configuration File Example

wrangler.toml:

toml

name = "sprouts-mcp-server"

main = "src/index.js"

compatibility_date = "2024-01-01"

[[kv_namespaces]]

binding = "SPROUTS_MCP_KV"

id = "your-kv-namespace-id"

[vars]

ENVIRONMENT = "production"

Service Level Objectives

Rate Limiting

Contact Information

💡 Need Help? Contact our support team at [email protected] or visit our documentation portal