omnisignal-mcp

# OmniSignal MCP Server

[![omnisignal-mcp MCP server](https://glama.ai/mcp/servers/omnisignal-ai/omnisignal-mcp/badges/card.svg)](https://glama.ai/mcp/servers/omnisignal-ai/omnisignal-mcp)

**Live market intelligence and AI content strategy for your brand — straight into your AI assistant.**

OmniSignal turns your brand profile into a data-driven social content operation: it collects fresh data from your niche (competitors, trends, audience), generates a multi-week content calendar, and surfaces daily signals (trends, competitor moves, opportunities). The entire backend is exposed as a **remote MCP (Model Context Protocol) server** — 38 tools your agent can call natively from Claude Code, Claude Desktop, Cursor, or any MCP-compatible client.

> ChatGPT and Claude are trained on stale snapshots. Same model, same prompt — the only difference is whether your agent can see this week.

## Server details

| | |
|---|---|
| **Transport** | Streamable HTTP (single endpoint, stateless) |
| **Server URL** | `https://mcp.omnisignal.ai/mcp` |
| **Auth** | `Authorization: Bearer omni_sk_...` (API key from the dashboard) |
| **Tools** | 38 (onboarding, strategy, signals, calendar, data, credits) |
| **Docs** | [Live API docs](https://mcp.omnisignal.ai/mcp/docs) · [Markdown for agents](https://mcp.omnisignal.ai/mcp/docs.md) |
| **Website** | [omnisignal.ai](https://www.omnisignal.ai) |

## Quickstart

### 1. Get an API key

Sign up at [app.omnisignal.ai](https://app.omnisignal.ai) → **Profile → MCP / API access** → create a key (`omni_sk_...`, shown once). Keys carry `read` + `generate` scopes, up to 10 active keys, revocable anytime. New accounts get **50 free starter credits**.

### 2. Connect your client

**Claude Code (CLI):**

```bash
claude mcp add --transport http omnisignal \
  https://mcp.omnisignal.ai/mcp \
  --header "Authorization: Bearer omni_sk_YOUR_KEY_HERE"
```

**Claude Code (plugin, from this repo):**

```
/plugin marketplace add omnisignal-ai/omnisignal-mcp
/plugin install omnisignal@omnisignal
```

Then set the `OMNISIGNAL_API_KEY` environment variable to your key — the plugin wires the header for you.

**Claude Desktop** (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "omnisignal": {
      "type": "streamable-http",
      "url": "https://mcp.omnisignal.ai/mcp",
      "headers": { "Authorization": "Bearer omni_sk_YOUR_KEY_HERE" }
    }
  }
}
```

**Cursor** (`~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "omnisignal": {
      "type": "streamable-http",
      "url": "https://mcp.omnisignal.ai/mcp",
      "headers": { "Authorization": "Bearer omni_sk_YOUR_KEY_HERE" }
    }
  }
}
```

**Any MCP client:** POST to the server URL with header `Authorization: Bearer omni_sk_YOUR_KEY_HERE` and `Accept: application/json, text/event-stream`.

### 3. Let the agent onboard you

Say: *"Set up my OmniSignal workspace."* The server ships with a built-in onboarding playbook — the agent checks readiness, collects your brand profile conversationally, analyzes your website, and kicks off your first strategy generation.

## What you can do with it

- **Monday market brief** — "What's moving in my market this week?" → fresh scan + a sourced brief of trends, competitor moves, and opportunities.
- **Battlecards / competitive response** — sourced gap analysis of what a competitor covers that you don't, with immediate actions.
- **Weekly planning** — walk this week's content calendar, playbooks included; A/B hook variants; mark posts published.
- **Export anywhere** — the calendar as CSV / ICS / JSON into Notion, Google Calendar, or a scheduler.
- **Deep data pulls** — fresh LinkedIn / Twitter / Instagram posts on any query when the agent needs raw material.

## Tool overview (38 tools)

Free tools are always free; paid tools require the `generate` scope and credits. Agents are instructed (via the server's built-in instructions) to check `credits_get_pricing` / `credits_get_balance` before running paid calls.

| Group | Tools | Price |
|---|---|---|
| Onboarding | `onboarding_get_readiness`, `onboarding_update_profile`, `onboarding_update_goals`, `onboarding_update_social_handles`, `onboarding_update_brand_voice`, `onboarding_update_content`, `onboarding_connect_platform`, `onboarding_analyze_website` | Free |
| Profile & strategy reads | `profile_get`, `strategy_get_latest`, `strategy_list`, `strategy_get_status`, `strategy_get_swot`, `strategy_get_themes` | Free |
| Strategy generation | `strategy_generate` (async), `strategy_analyze_post_idea`, `strategy_competitor_gap` | 150 / 8 / 12 cr |
| Signals | `signals_scan` (async) + `signals_scan_status` (free), `signals_list`, `signals_generate`, `signals_dismiss`, `signals_snooze`, `sources_list` (free), `sources_discover` | 25 cr scan, 5 cr/list window, 10 cr generate/discover |
| Calendar | `calendar_get_day`, `calendar_get_week`, `calendar_get_upcoming` (free), `calendar_get_post`, `calendar_search_posts`, `calendar_update_post` (free), `calendar_create_variants`, `calendar_export` | 5 cr day / 15 cr week / 3 cr post / 3 cr search / 8 cr variants / 5 cr export |
| Data | `data_summary` (free), `data_collect`, `data_points_list` | 2–10 cr |
| Credits meta | `credits_get_balance`, `credits_get_pricing` | Free |

Design notes: async jobs (`strategy_generate`, `signals_scan`) return a job id to poll and auto-refund on failure; responses are chunked for LLM context (signal windows of 10, calendar day-by-day with a week bulk discount); paid mutations are idempotent; per-user daily spend cap.

## Pricing

**1 credit = $0.15**, metered to Stripe on every paid call.

| Package | Price/mo | Credits | Effective $/cr |
|---|---|---|---|
| Starter | $25 | 250 | $0.10 |
| Creator | $49 | 550 | $0.089 |
| Pro | $99 | 1,200 | $0.083 |
| Team | $199 | 2,600 | $0.077 |
| PAYG | — | $0.15/cr, billed daily in arrears | $0.15 |

- 50 free starter credits on the free/PAYG tier.
- Monthly packages never hard-stop: overage auto-bills in round-up blocks at the package rate.
- Any MCP package also unlocks the full OmniSignal dashboard on the same account.

## Links

- Product site: [omnisignal.ai](https://www.omnisignal.ai)
- Dashboard: [app.omnisignal.ai](https://app.omnisignal.ai)
- Live MCP docs: [/mcp/docs](https://mcp.omnisignal.ai/mcp/docs)
- This repo also contains `server.json` (Official MCP Registry manifest) and a Claude Code plugin marketplace manifest (`.claude-plugin/marketplace.json`).

## License

MIT — see [LICENSE](LICENSE). The hosted OmniSignal service itself is commercial; this repo contains listing metadata and documentation only.