Growth Intel MCP
Zero-PII, read-only CRM and revenue intelligence MCP server for 3-dimensional lead intent scoring, natural language lead search, pipeline overview, and multi-channel ad attribution (Meta, Google Ads, WhatsApp).
Documentation
1. Authentication & Sandbox Environment
All production REST API requests require a per-tenant Bearer token in the Authorization header.
Instant Sandbox Mode for Autonomous Agents
AI agents and developers can test all endpoints immediately without signing up or requesting manual approval using our public sandbox demo key:
Authorization: Bearer gi_sandbox_live_demo_key
2. Core API Endpoints
GET /api/v1
Returns API service health, active endpoint catalog, and OpenAPI references.
curl -sS https://growthintel.net/api/v1
POST /api/v1/leads
Ingest an inbound prospect from ads, webhooks, or landing pages. Computes real-time intent score (0-100) and triggers instant routing.
curl -sS -X POST https://growthintel.net/api/v1/leads \
-H "Authorization: Bearer gi_sandbox_live_demo_key" \
-H "Content-Type: application/json" \
-d '{
"source": "meta_ads",
"campaign_id": "1202094829384",
"metadata": {
"industry": "Healthcare",
"company_size": "50-200"
}
}'
GET /api/v1/leads/semantic-search?q={query}
Contextual semantic search across lead profiles and activity, ranked by relevance.
curl -sS "https://growthintel.net/api/v1/leads/semantic-search?q=SaaS+exploring+CRM" \
-H "Authorization: Bearer gi_sandbox_live_demo_key"
POST /api/v1/webhooks/conversions
Ingest closed-deal revenue feedback. Feeds conversion signals to Google Ads and Meta Ads smart bidding.
curl -sS -X POST https://growthintel.net/api/v1/webhooks/conversions \
-H "X-Conversion-Secret: your_conversion_secret" \
-H "Content-Type: application/json" \
-d '{
"lead_id": 1042,
"value": 12500.00,
"currency": "USD"
}'
3. Model Context Protocol (MCP) Server
For autonomous LLMs and agent frameworks (Claude Desktop, Cursor, Antigravity, OpenAI Codex, LangChain), Growth Intel provides a native Streamable HTTP MCP server with instant zero-PII sandbox support:
Endpoint: https://growthintel.net/mcp/leads
Manifest: https://growthintel.net/.well-known/mcp.json
Sandbox: Authorization: Bearer gi_sandbox_live_demo_key
Available Tools (8 Read-Only, Zero-PII Tools):
search-leads-tool: Filter leads by status, source, intent score, budget tier.search-leads-by-natural-language-tool: Natural-language query mapped to safe filter whitelist.campaign-performance-tool: Ad spend, lead count, conversions, and CPL metrics.pipeline-overview-tool: Deal pipeline breakdown by status, source, or budget tier.task-summary-tool: Open, overdue, and recently completed sales rep task counts.creative-performance-tool: Ad creative asset conversion rankings and LLM copy labels.creative-strategy-recommendations-tool: Audience segments to scale or prune based on pipeline ROI.social-content-recommendations-tool: High-engagement organic posts worth promoting as lead-gen ads.
4. Official CLI Tool
Automate and inspect Growth Intel directly from the command line:
# One-line installer:
curl -fsSL https://growthintel.net/install.sh | bash
# Or run with Node:
growthintel status --token=gi_sandbox_live_demo_key
growthintel leads search "high intent SaaS"
5. Structured Error Handling
All API errors return machine-readable JSON containing error codes, descriptive messages, and actionable resolution hints:
{
"error": {
"code": "UNAUTHORIZED",
"message": "Missing API token.",
"resolution_hint": "Provide a valid token via 'Authorization: Bearer <API_TOKEN>'. For automated testing, use sandbox token 'gi_sandbox_live_demo_key'."
}
}