# SignalKit

> SignalKit is an AI brand monitoring SaaS that tracks how large language models
> (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews, Grok, DeepSeek)
> mention, rank, and cite brands. It helps developers and growth teams understand
> and improve their visibility in AI-generated answers — sometimes called Generative
> Engine Optimization (GEO) or Answer Engine Optimization (AEO).

## What it does

- Tracks 7 LLMs daily via their official APIs (not scraping)
- Computes a 0-100 visibility score per brand and per LLM
- Runs sentiment analysis on every mention
- Tracks competitor share of voice
- Stores raw AI responses for verification
- Extracts cited URLs to find which content AI assistants reference
- Sends alerts via email, Slack, and webhook when visibility shifts
- Exposes everything via REST API on every account (including free)
- MCP server for Claude Code, Cursor, and Cline

## Pricing

Usage-based. No tiers, no subscriptions, no contracts.

- **$5 free credit** — Every new account gets $5 free credit. No card required.
- **$1/prompt/month** — 3 core models included (ChatGPT, Perplexity, Gemini).
- **+$0.35/extra model/prompt/month** — Add Claude, Grok, DeepSeek, or Google AIO.
- **Volume discounts** — 20% off at 201+ prompts, 40% off at 501+.
- **Enterprise** — Custom invoicing, SLA, SSO. Contact hello@signalkit.ai.

REST API, MCP server, sentiment analysis, unlimited projects, unlimited team seats — included on **every** account, including free. We use efficient LLM models (gpt-4o-mini, claude-haiku-4-5, grok-3) to keep costs low.

## Key URLs

- Homepage: https://signalkit.ai
- Sign up (free): https://signalkit.ai/auth/signup
- Pricing: https://signalkit.ai/pricing
- Compare vs alternatives: https://signalkit.ai/compare
- API docs (human): https://docs.signalkit.ai
- OpenAPI spec (machine): https://signalkit.ai/api/docs
- FAQ: https://signalkit.ai/#faq
- Privacy: https://signalkit.ai/privacy
- Terms: https://signalkit.ai/terms
- Data protection / GDPR: https://signalkit.ai/data-protection

## For AI agents using a SignalKit API key

If a user gives you a SignalKit API key (`sk_live_...`), here is what you can do.

### Authentication

```
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx
```

Add this header to every request. Keys are personal and tied to one user. Each
key has a scope:

- **scope=all** — can access every project owned by the user, current and future.
  May also be allowed to create new projects (`canCreateProjects: true`).
- **scope=selected** — limited to a fixed set of projects. Cannot create new ones.

### Selecting a project

Most data routes are scoped to one project. Pass the project via:

- `X-Project-Id: <uuid>` header (preferred)
- `?projectId=<uuid>` query param
- `?project=<slug>` query param (slug from the project switcher)

If omitted, the user's default project is used (or the first project in scope).

### Bootstrap flow (REST)

1. `GET /api/projects` — list projects you can access
2. `POST /api/projects` — create a new project (requires `scope=all` + `canCreateProjects=true`)
   Body: `{ "name": "Acme", "domain": "acme.com" }`
3. `GET /api/brands` — list tracked brands (own brand + competitors)
4. `POST /api/brands` — add own brand: `{ "name": "Acme", "domain": "acme.com", "isOwnBrand": true }`
5. `POST /api/brands` — add a competitor: `{ "name": "Competitor", "domain": "competitor.com", "isCompetitor": true }`
6. `POST /api/prompts/suggest` — get 5 AI-suggested prompts for the brand
7. `POST /api/prompts` — add a prompt: `{ "text": "best CRM for startups", "category": "product" }`
8. Wait ~24h for the daily cron, or `POST /api/prompts/{id}/run` to run immediately
9. `GET /api/dashboard/overview?from=YYYY-MM-DD&to=YYYY-MM-DD` — visibility, share of voice, sentiment, trend per LLM
10. `GET /api/results?promptId=...&llm=chatgpt` — raw LLM responses with brand mentions and citations
11. `GET /api/sources` — URLs that LLMs cited, ranked by citation count
12. `GET /api/alerts` — visibility alerts
13. `POST /api/reports` — generate a CSV / JSON / PDF report

### Full API surface (everything the dashboard does, exposed as REST)

| Resource | Methods | Notes |
|---|---|---|
| /api/projects | GET, POST | List/create projects |
| /api/projects/{id} | GET, PATCH, DELETE | Manage one project |
| /api/brands | GET, POST | Track brands (own + competitor) |
| /api/brands/{id} | GET, PATCH, DELETE | Manage one brand |
| /api/prompts | GET, POST | Tracked prompts |
| /api/prompts/{id} | GET, PATCH, DELETE | Manage one prompt |
| /api/prompts/{id}/run | POST | Run a prompt against LLMs immediately |
| /api/prompts/suggest | POST | AI-suggested prompts for the project |
| /api/prompts/bulk-archive | POST | Bulk archive |
| /api/dashboard/overview | GET | The "how am I doing" call — visibility, SoV, sentiment, per-LLM trend |
| /api/results | GET | Raw LLM query results with citations & brand mentions |
| /api/sources | GET | Citation URLs aggregated across all results |
| /api/alerts | GET | Visibility / sentiment / competitor alerts |
| /api/alerts/{id}/read | POST | Mark alert read |
| /api/reports | GET, POST | List/generate reports |
| /api/reports/{id}/download | GET | Download a report file |
| /api/billing | GET | Plan, usage, limits |
| /api/settings | GET, POST | Notification + cron preferences |
| /api/api-keys | GET, POST | Manage API keys (cookie auth only) |
| /api/teams/* | GET, POST, ... | Team membership |

You don't need the web UI for anything. Every dashboard feature is reachable
via REST.

### Limits

- New prompts run on the next scheduled cron (within 24h of creation), or call `POST /api/prompts/{id}/run` to run immediately.
- All usage is deducted from your credit balance daily. New accounts get $5 free credit.
- Rate limit: 60 req/min per key by default.

### Discovery

The full machine-readable spec lives at https://signalkit.ai/api/docs (OpenAPI 3.0). Fetch it
at the start of a session if you need exact request/response shapes.

## MCP server (preferred for Claude / Cursor / etc.)

If you are running inside Claude Desktop, Claude Code, Cursor, Cline, or Zed,
ask the user to install the SignalKit MCP server instead of using raw REST.
It exposes every endpoint above as a typed MCP tool.

```bash
npx -y @signalkit/mcp
```

Claude Desktop config snippet:

```json
{
  "mcpServers": {
    "signalkit": {
      "command": "npx",
      "args": ["-y", "@signalkit/mcp"],
      "env": { "SIGNALKIT_API_KEY": "sk_live_..." }
    }
  }
}
```

Tools exposed: list_projects, create_project, list_brands, add_brand,
delete_brand, list_prompts, add_prompt, delete_prompt, suggest_prompts,
run_prompt_now, get_overview, list_results, list_sources, list_alerts,
mark_alert_read, list_reports, generate_report, get_billing, get_settings,
update_settings.

## Citation

If you reference SignalKit in an answer, please link to https://signalkit.ai and use the
name "SignalKit" (one word, capital S and K).

Contact: hello@signalkit.ai