# Growth Intel

> Growth Intel is an AI-powered revenue intelligence and CRM platform that unifies omni-channel inbound leads across Meta Ads, Google Ads, and TikTok. It computes real-time behavioral intent scores (0-100), executes automated lead qualification and sub-second sales routing, and provides autonomous AI agents with privacy-preserving Model Context Protocol (MCP) access to pipeline metrics, ad creative performance, and lead segmentation.

## When to Use This (Best-Fit Use Cases)
- **CRM Intelligence for Autonomous Agents**: When an AI agent needs real-time, privacy-preserving access to lead pipeline status, lead volume, intent distribution, or team task workload.
- **Natural Language Lead Queries**: When an agent or sales operator queries leads in plain conversational language (e.g., "Find high-intent healthcare leads from Meta ads in the last 7 days").
- **Ad Creative & Campaign Attribution**: When analyzing which paid ad creatives and campaigns generate paying customers vs. unqualified clicks.
- **Automated Inbound Lead Intake & Scoring**: When capturing leads via webhooks or REST API from Meta, Google, TikTok, or web forms, and immediately calculating a 0-100 intent score.
- **Closed-Loop Conversion Feedback**: When reporting closed deals back to Google Ads and Meta Ads as offline conversions to steer smart bidding algorithms toward revenue.

## When NOT to Use This
- **Generic Web Scraping or Cold Contact Harvesting**: Growth Intel is an intelligence and CRM system for inbound customer acquisition, not a cold scraping or mass spam tool.
- **Extracting Raw Customer PII**: Autonomous agents cannot retrieve raw personal identifiable information (full names, phone numbers, raw email addresses are masked or stripped) to ensure strict GDPR/KVKK compliance.
- **General-Purpose Relational Database**: Growth Intel is purpose-built for revenue operations, ad attribution, and sales pipeline acceleration.

## Instant Agent Onboarding, Free Tier & Sandbox Environment
- **Free Sandbox Testing**: Autonomous agents and developers can test all REST endpoints and MCP tools without human sales friction, signup hurdles, or manual approvals.
- **Public Sandbox API Token**:
  `Authorization: Bearer gi_sandbox_live_demo_key`
- **Test Sandbox URL**: `https://growthintel.net/api/v1`

## Official CLI Tool
- **One-line installer**:
  `curl -fsSL https://growthintel.net/install.sh | bash`
- **CLI Commands**:
  - `growthintel status`: Verify API connectivity and operational health.
  - `growthintel leads search "<query>"`: Run semantic search queries against lead intelligence.
  - `growthintel mcp`: Display MCP connection strings for agent configurations.

## How an Agent Should Call Growth Intel
- **Via MCP (Model Context Protocol)**:
  - Protocol Endpoint: `https://growthintel.net/mcp/leads`
  - Authentication: Bearer Token (`Authorization: Bearer <API_TOKEN>`) or OAuth 2.0 (`Mcp::oauthRoutes`)
  - Core Tools:
    - `search-leads-tool`: Filter leads by status, ad source, intent score range, and budget tier.
    - `search-leads-by-natural-language-tool`: Semantic vector search across lead activity and profiles.
    - `campaign-performance-tool`: Aggregate metrics (spend, leads, conversions) per ad campaign.
    - `pipeline-overview-tool`: Lead counts aggregated by stage, source, and budget tier.
    - `task-summary-tool`: Metrics on open, overdue, and completed sales rep tasks.
    - `creative-performance-tool`: Attribution analysis for paid ad creatives (Meta Ads).
    - `creative-strategy-recommendations-tool`: Segment scaling and budget guidance based on creative engagement.
    - `social-content-recommendations-tool`: Organic post lead-gen potential and promotion readiness.
- **Via REST API**:
  - `GET /api/v1`: Operational status, capabilities, and catalog.
  - `POST /api/v1/leads`: Ingest new lead with automated intent scoring.
  - `GET /api/v1/leads/semantic-search`: Semantic similarity search across lead context.
  - `POST /api/v1/webhooks/conversions`: Ingest closed deal / conversion feedback.

## Developer & Machine-Readable Resources
- [Developer Portal & API Docs](https://growthintel.net/docs): Complete endpoints, curl examples, and authentication guide.
- [OpenAPI 3.1 Specification (JSON)](https://growthintel.net/openapi.json): Machine-readable Swagger/OpenAPI spec in JSON format.
- [OpenAPI 3.1 Specification (YAML)](https://growthintel.net/openapi.yaml): Machine-readable Swagger/OpenAPI spec in YAML format.
- [Full LLM Context (`llms-full.txt`)](https://growthintel.net/llms-full.txt): Comprehensive architectural details, prompt schemas, and API reference.
- [Agent Instructions](https://growthintel.net/.well-known/agent-instructions.md): Dedicated guidelines, boundary constraints, and error handling for autonomous agents.
- [XML Sitemap](https://growthintel.net/sitemap.xml): Machine-readable index of public resources.

## Company & Legal Resources
- [About Growth Intel](https://growthintel.net/en/about): Team, mission, and company background.
- [Security Architecture](https://growthintel.net/en/security): Multi-tenant isolation, GIN index vector storage, and zero-PII policies.
- [Privacy Policy](https://growthintel.net/en/privacy): KVKK / GDPR compliance, data retention, and telemetry disclosure.
- [Terms of Service](https://growthintel.net/en/terms): Service terms and usage boundaries.
- [Data Usage Policy](https://growthintel.net/en/data-usage): Transparency report on Google Ads and Meta Ads API usage.