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 battlecard1 credit
GET/v1/companies/{id}/signalsList signalsFree
GET/v1/companies/{id}/signals/summarySignal digestFree
POST/v1/ai/chatAsk AIFree

Enablement Focus Types

When generating battlecards, use one of these focus types:

  • gtm_sales (default)
  • product
  • marketing_growth
  • leadership

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.