@kynver-app/mcp-analyst

Kynver Analyst MCP server. Proxies 56 tools to /api/agents/analyst/* on your Kynver deployment — dashboards, memory, hypotheses, trackers, research (analyst_research uses Perplexity where configured), data collection, daily-intelligence scheduling (including analyst_schedule_weekly_pipeline), predictions, patterns, notifications, and the analyst_market_* trading-desk surface.

This is the external MCP surface for Claude Code, Cursor, OpenClaw, etc. The in-app Kynver agent uses separate synthetic dispatch; this package is for clients that talk HTTP to a live Kynver app.

Agentic OS (agent_os_*) lives in a sibling package: @kynver-app/mcp-agent-os. Mount both MCP servers if you need analyst + structured agent identity / goals / projects / Ghost memory.

Tools (overview)

| Family | Count | Notes | |--------|------:|--------| | analyst_* (general) | 40 | Memory, dashboards, collections, hypotheses, trackers, scheduling (daily + weekly pipeline), research, intent/setup, daily reports & schedules, addenda, insiders ingest, fear & greed, predictions, patterns, notification prefs | | analyst_market_* | 16 | Admin-only on Kynver — market data, backtests, paper accounts, proposals, orders, positions, bars, chains |

Full JSON schemas are kept in the Kynver repo at lib/mcp/tool-manifests/kynver-mcp-analyst.json (used as a static fallback where stdio spawn is unavailable).

Env

| Var | Purpose | |-----|---------| | KYNVER_API_URL | Kynver origin (e.g. https://kynver.com). In development, stdio may default to http://localhost:3000 if unset — production MCP hosts should set this explicitly. | | KYNVER_API_KEY | Bearer token sent as Authorization. Required for authenticated calls to user-scoped analyst routes. | | KYNVER_SERVICE_SECRET | Required when using SSE transport so the server can forward X-Kynver-User-Id + service secret after resolving the API key owner (see src/sse.ts). | | KYNVER_FETCH_TIMEOUT_MS | Optional HTTP timeout for upstream Kynver calls (default 120000). | | PORT | SSE listener port (default 3100 — differs from @kynver-app/mcp-agent-os, which defaults to 3101). |

Trading desk: analyst_market_* routes enforce requireAdminUser on the API. Your API key must belong to a Kynver admin (ADMIN_USER_IDS / ADMIN_EMAILS on the server).

Transports

• Stdio (default): node dist/index.js or the kynver-mcp-analyst bin — set KYNVER_API_URL + KYNVER_API_KEY.
• SSE: npm run start:sse / node dist/sse.js — exposes /sse and /messages; external clients authenticate with an API key; requires KYNVER_SERVICE_SECRET aligned with the web app for impersonation headers.

Cursor / OpenClaw config (published package)

{
  "mcpServers": {
    "kynver-analyst": {
      "command": "npx",
      "args": ["-y", "@kynver-app/mcp-analyst"],
      "env": {
        "KYNVER_API_URL": "https://kynver.com",
        "KYNVER_API_KEY": "${KYNVER_API_KEY}"
      }
    }
  }
}

Add a second block for kynver-agent-os using @kynver-app/mcp-agent-os when you need Agentic OS tools (see that package’s README).

Monorepo dev

From repo root:

npm install
cd packages/kynver-mcp-analyst
npm run build
node dist/index.js

Publish after build:

npm publish --access public