// docs / mcp
MCP sirwiq
Plug FixVibe into Claude Desktop, Cursor, utaq any client that speaks chay Model Context Protocol. Your AI agent gets typed access man niyki qhawaykuna, tarisqakuna, hinallataq chay same templated fix prompts that power chay dashboard's Kikinchay fix prompt button.
Mint an API token
Visit /yupay/api-tokens hinallataq create a token named, e.g., claude-desktop. Kikinchay chay plaintext value — it's shown once.
Tokens kanku bearer credentials: anyone wan chay string atin read niyki qhawaykuna hinallataq start musuq ones. Store it like a password.
Point niyki MCP client at /api/mcp
Claude Desktop / Cursor / Continue / Zed:
{
"mcpServers": {
"fixvibe": {
"transport": "streamable-http",
"url": "https://fixvibe.app/api/mcp",
"headers": {
"Authorization": "Bearer fxv_YOUR_TOKEN_HERE"
}
}
}
}Restart chay client. The fixvibe server should appear in its MCP sirwiq list.
Try it out
Ask niyki agent things like:
- “List my last 10 FixVibe qhawaykuna.”
- “Show me chay critical tarisqakuna on chay most recent qhaway.”
- “Start a passive qhaway against
https://staging.example.com.” - “For each high-severity tarisqa on qhaway X, write a fix.”
- “Are there any open live-threat willaykuna on my dominiokuna?”
- Type
/fixvibe-fixwan a tarisqa id man drop chay templated remediation prompt straight into chay chat.
Llamk'anakuna
- list_scansread
- Returns up man 100 most-recent qhawaykuna wan status + tarisqa counts. Args: limit?: 1..100.
- get_scanread
- Scan envelope + per-category severity summary by default. Set include_findings=true paq chay full willakuy (large paq noisy qhawaykuna — prefer list_findings + filters). Args: scan_id (uuid), include_findings?: boolean.
- list_findingsread
- Paginated tarisqakuna across all niyki qhawaykuna. Args: severity?: list, check_id?, since? (ISO 8601), limit?: 1..200.
- start_scanwrite
- Enqueues a scan and returns an id with status queued; poll get_scan to await completion. Passive mode is always available through MCP. Active mode requires a paid plan plus verified-domain authorization from the dashboard. Args: target (URL or hostname), mode? (passive|active).
- list_alertsread
- Direkto amenaza willaykuna (CT log diferenciakuna, DNS muyusqakuna, threat intel listas). Unlimited planpi sapallam tarikun; Hobby Pro plankunaqa ch'usaq listata kutichinku. Args: domain_id?, active_only?, limit?: 1..200.
- get_alertread
- Single alert with the relevant domain, severity, type, and event details. Args: alert_id (uuid).
- dismiss_alertwrite · idempotent
- Mark an willay dismissed. Idempotent — re-dismissing kan a mana-op. Args: alert_id (uuid).
Yanakuna
Yanakuna let niyki client attach FixVibe willakuy into chay conversation directly, instead of chay agent re-fetching it on sapa turn. In Claude Desktop, click chay @ menu → fixvibe.
- fixvibe://scan/{scan_id}/reportjson
- Full FixVibe qhaway willakuy including sapa check hinallataq sapa tarisqa.
- fixvibe://finding/{finding_id}json
- A single tarisqa (severity, title, description, evidence, remediation, CWE).
Slash commands
- /fixvibe-fixprompt
- Renders a server-side remediation prompt for a finding, using scan context when available and falling back to generic guidance otherwise. Args: finding_id (uuid). No third-party LLM API call is made by FixVibe.
→ Quotas, RLS, hinallataq severity gating apply identically man MCP hinallataq REST calls.
