Install MCP
Kifas ships a thin proxy CLI on npm — @kifas/mcp — that bridges your MCP client’s
stdio transport to our hosted Streamable HTTP server.
1. Install
Section titled “1. Install”# Global (one-time)npm install -g @kifas/mcp
# Per-projectbun add @kifas/mcp# or: pnpm add @kifas/mcp / npm install @kifas/mcp2. Mint an API key
Section titled “2. Mint an API key”In app.kifas.io → Settings → API keys, click Create key. The value (begins
with kifas_live_) is shown exactly once — copy it now.
3. Configure your client
Section titled “3. Configure your client”Cursor
Section titled “Cursor”Edit .cursor/mcp.json in your project root (create if absent):
{ "mcpServers": { "kifas": { "command": "npx", "args": ["-y", "@kifas/mcp"], "env": { "KIFAS_API_KEY": "kifas_live_..." } } }}Restart Cursor. The kifas.* tools appear in the agent’s tool list.
Claude Code
Section titled “Claude Code”Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or
the platform equivalent:
{ "mcpServers": { "kifas": { "command": "npx", "args": ["-y", "@kifas/mcp"], "env": { "KIFAS_API_KEY": "kifas_live_..." } } }}Continue
Section titled “Continue”Add the same mcpServers block to your ~/.continue/config.json.
Custom MCP client
Section titled “Custom MCP client”Speak Streamable HTTP
directly to https://mcp.kifas.io/. Send Authorization: Bearer kifas_live_...
on every request. The first frame must be initialize; we return an
Mcp-Session-Id header you echo on every subsequent request.
Troubleshooting
Section titled “Troubleshooting”unauthorizedon every call — yourKIFAS_API_KEYenv var is unset, expired, or revoked. Mint a new one.- Cursor doesn’t show kifas tools — restart Cursor after editing
.cursor/mcp.json; Cursor reads MCP config only at startup. runner_saturated— our server is at capacity. Retry with backoff; the@kifas/mcpCLI does this automatically.
See the errors reference for the full error code catalog.