AI Onboarding

Everything an AI agent needs to know to use Signal Labs.

What is Signal Labs?

Signal Labs is a competitive intelligence platform. It lets you track competitors, generate AI-powered battlecards, and monitor competitive signals via API or MCP.

Authentication

API key in the Authorization header:

HTTP
Authorization: Bearer sl_live_...

Get a key at app.usesignallabs.com/settings.

Base URL: https://app.usesignallabs.com/api/v1

Core Workflow

  1. Create a company: POST /v1/companies with {"domain": "example.com"}
  2. Discover competitors: POST /v1/companies/{id}/competitors/discover
  3. Add competitors: POST /v1/companies/{id}/competitors
  4. Generate battlecards: POST /v1/companies/{id}/battlecards/generate (1 credit)
  5. Monitor signals: GET /v1/companies/{id}/signals
  6. Ask AI: POST /v1/ai/chat with {"message": "...", "company_id": "..."}

Products are optional. If not specified, competitors default to company-level.

Endpoints

MethodPathDescriptionCost
GET/v1/companiesList companiesFree
POST/v1/companiesCreate companyFree
GET/v1/companies/{id}Get companyFree
GET/v1/companies/{id}/productsList productsFree
POST/v1/companies/{id}/productsCreate productFree
GET/v1/companies/{id}/competitorsList competitorsFree
POST/v1/companies/{id}/competitorsAdd competitorsFree
POST/v1/companies/{id}/competitors/discoverAI discoverFree
GET/v1/companies/{id}/battlecardsList battlecardsFree
POST/v1/companies/{id}/battlecards/generateGenerate battlecard. Optional: include special_instructions (max 10,000 chars) to provide custom context or focus areas.1 credit
GET/v1/companies/{id}/signalsList signalsFree
GET/v1/companies/{id}/signals/summarySignal digestFree
POST/v1/ai/chatAsk AIFree
POST/v1/documents/uploadUpload document (multipart, max 25MB)Free
GET/v1/documentsList documentsFree
GET/v1/documents/{id}Get documentFree
DELETE/v1/documents/{id}Delete documentFree

Documents are automatically processed for RAG (parsing, chunking, embedding). Use document_ids when generating battlecards to include as context (max 100k chars combined).

Enablement Focus Types

When generating battlecards, use one of these focus types:

  • gtm_sales (default)
  • product
  • marketing_growth
  • leadership
  • landscape

Note: landscape requires competitor_ids (an array of 2+ IDs) instead of competitor_id.

MCP Server

For AI tools, use the MCP server:

Bash
npx signallabs-mcp

Requires the SIGNALLABS_API_KEY environment variable. See the MCP setup guide for full details.