Competiflow Server
БесплатноНе проверенTrack competitors, run discovery, read the interpreted change feed, triage items, and pull workspace digests without leaving your AI client.
Описание
Track competitors, run discovery, read the interpreted change feed, triage items, and pull workspace digests without leaving your AI client.
README
MCP (Model Context Protocol) server for Competiflow. Use competitor monitoring as tools in Cursor, Claude Desktop, Windsurf, and any MCP-compatible client.
Track competitors, run discovery, read the interpreted change feed, triage items, and pull workspace digests without leaving your AI client.
Setup
Create an API key in the Competiflow dashboard under API keys, then add the server to your client config. COMPETIFLOW_API_KEY is the only variable you need.
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"competiflow": {
"command": "npx",
"args": ["-y", "@competiflow/mcp-server"],
"env": {
"COMPETIFLOW_API_KEY": "sk_live_your_key_here"
}
}
}
}
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"competiflow": {
"command": "npx",
"args": ["-y", "@competiflow/mcp-server"],
"env": {
"COMPETIFLOW_API_KEY": "sk_live_your_key_here"
}
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"competiflow": {
"command": "npx",
"args": ["-y", "@competiflow/mcp-server"],
"env": {
"COMPETIFLOW_API_KEY": "sk_live_your_key_here"
}
}
}
}
Available Tools
| Tool | API | Description |
|---|---|---|
list_workspaces |
GET /v1/workspaces |
List workspaces with review counts |
create_workspace |
POST /v1/workspaces |
Create a workspace (optional product_url) |
update_workspace |
PATCH /v1/workspaces/:id |
Rename, set or clear product_url, or pause/resume every monitor |
delete_workspace |
DELETE /v1/workspaces/:id |
Remove a workspace and all its history |
add_competitor |
POST /v1/workspaces/:id/competitors |
Add a competitor by homepage URL. Async discovery, idempotent on duplicate URL |
list_competitors |
GET /v1/workspaces/:id/competitors |
List competitors with monitors and last_run |
get_competitor |
GET /v1/competitors/:id |
Read one competitor |
update_competitor |
PATCH /v1/competitors/:id |
Set cadence or status on all its monitors |
delete_competitor |
DELETE /v1/competitors/:id |
Remove a competitor and all its history |
list_monitors |
GET /v1/monitors |
List monitors with status, cadence, and last_run |
get_monitor |
GET /v1/monitors/:id |
Read one monitor. Pass include for capture evidence |
create_monitor |
POST /v1/monitors |
Add a manual monitor on a specific URL |
update_monitor |
PATCH /v1/monitors/:id |
Update URL, cadence, status, or min_severity |
delete_monitor |
DELETE /v1/monitors/:id |
Remove a monitor and all its history |
check_monitor |
POST /v1/monitors/:id/check |
Queue an on-demand check |
refresh_workspace |
POST /v1/workspaces/:id/refresh |
Queue checks for active monitors |
list_changes |
GET /v1/changes |
Change feed with since, filters, and meta counts |
get_change |
GET /v1/changes/:id |
Full change. Pass include for capture or raw diff |
update_change |
PATCH /v1/changes/:id |
Set review_status |
get_digest |
GET /v1/workspaces/:id/digest |
Weekly workspace summary |
Every tool declares MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint), so clients can ask before running the delete_* tools.
Prompts
| Prompt | Arguments | What it does |
|---|---|---|
weekly_briefing |
workspace_id?, period? |
Summarizes competitor activity for a period, most important first |
triage_changes |
workspace_id?, min_severity? |
Walks the unreviewed inbox and proposes acknowledge or dismiss, then asks before updating |
track_competitor |
url, workspace_id? |
Adds a competitor, waits for discovery, and reports what is monitored |
Without workspace_id, each prompt starts with list_workspaces.
Resources
| URI | Type | Contents |
|---|---|---|
competiflow://guide |
text/markdown |
Agent guide: the typical flow, discovery, evidence, and delete versus pause |
competiflow://workspaces/{workspace_id}/digest |
application/json |
7-day digest of one workspace. Clients that list resources show one per workspace. |
Typical flow
list_workspacesorcreate_workspace(optionalproduct_urlimproves competitive context on changes).add_competitorwith a homepage URL.get_competitoruntildiscovery_statusiscompleted.refresh_workspaceorcheck_monitorto pull fresh data.list_changeswithsince=7dandmin_severity, orget_digestfor a summary.get_changewithincludewhen you need evidence.update_changeto acknowledge or dismiss items.
Discovery and idempotency
add_competitor starts discovery in the background and returns an acknowledgement, not the finished result. Poll get_competitor until discovery_status is completed.
A workspace runs one discovery at a time. Posting the same homepage URL again returns the existing competitor without starting a second run. If a different competitor is still discovering, the call returns 409 discovery_in_progress with active_competitor_id so you know which one to poll.
Evidence with include
get_change and get_monitor accept an include array to attach the underlying capture in one call:
| Token | Available on | Returns |
|---|---|---|
capture |
get_change, get_monitor |
Extracted fields from the snapshot |
capture_markdown |
get_change, get_monitor |
Page markdown from the snapshot |
raw_diff |
get_change |
Before and after diff for the change |
For a change the capture is the post-change page. For a monitor it is the latest successful check, which is the current baseline.
Delete versus pause
delete_monitor, delete_competitor, and delete_workspace are permanent. They remove the record along with its check runs, snapshots, and changes. To stop checks while keeping intel history, call update_monitor, update_competitor, or update_workspace with status: paused instead.
delete_workspace returns 409 discovery_in_progress while a competitor in the workspace is still being discovered.
Agent guidelines (for AI clients)
- Poll discovery, do not assume: after
add_competitor, pollget_competitoruntildiscovery_statusiscompletedbefore reading changes. On409, poll theactive_competitor_idfrom the error. - Filter the feed: pass
since(1d,7d,30d, or ISO8601),min_severity,monitor_type(homepage,blog,docs,changelog,pricing), andreview_statustolist_changesinstead of pulling everything. Usemeta.countsfor inbox totals andnext_cursorto page. - Interpretation fields: changes and digest items expose
why_it_mattersfor competitive context.recommended_actionwas removed from the API. - Fetch evidence on demand: only add
includetoget_changeorget_monitorwhen you need the underlying capture. It adds payload. - Prefer pause over delete: default to
status: pausedwhen a user wants to stop a monitor. Reservedelete_*for permanent removal, since it drops history.
How it works
The server translates each tool call into a Competiflow v1 API request and returns structured JSON. Your agent sees interpreted changes, severity, and why it matters instead of raw page scrapes.
AI Agent → MCP Tool Call → Competiflow API → Interpreted Change Feed → Structured Response → AI Agent
Environment variables
| Variable | Required | Description |
|---|---|---|
COMPETIFLOW_API_KEY |
Yes | Your Competiflow API key (sk_live_...) |
Get an API key
Sign up at competiflow.com and create a key under API keys.
Development
npm install
npm run build
COMPETIFLOW_API_KEY=sk_live_... node dist/index.js
npm test builds and runs a smoke test that starts the server without a key, the way directory scanners do, and checks the tools, annotations, prompts, and resources.
License
MIT
Установка Competiflow Server
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/nyku/competiflow-mcpFAQ
Competiflow Server MCP бесплатный?
Да, Competiflow Server MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Competiflow Server?
Нет, Competiflow Server работает без API-ключей и переменных окружения.
Competiflow Server — hosted или self-hosted?
Доступен hosted-вариант: Unyly запускает сервер в облаке, локальная установка не обязательна.
Как установить Competiflow Server в Claude Desktop, Claude Code или Cursor?
Открой Competiflow Server на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
Opencode Omniroute Plugin
OpenCode plugin for the OmniRoute AI Gateway. Drives dynamic model discovery, /connect auth flow, and multi-instance OmniRoute providers via the official @openc
автор: GitHub ActionsRoblox Studio
Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, sce
автор: paralovAntigravity Drawio
MCP server that enables AI assistants to create, parse, render, and validate Draw.io diagrams programmatically.
автор: S-SUJAN-SFetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
автор: modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
автор: xuzexin-hzMCP-Agent
A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)
автор: lastmile-aiSpring AI MCP Client
Provides auto-configuration for MCP client functionality in Spring Boot applications.
mcp.natoma.ai
A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)
Compare Competiflow Server with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории ai
