@simplr-ai/dev-mcp

@simplr-ai/dev-mcp

An MCP server that helps AI coding agents (Claude Code, Cursor, etc.) integrate every Simplr feature into your codebase — bundled integration guides + per-language code snippets, plus a few live tools to verify the integration against the real API.

Not to be confused with @simplr-ai/mcp, the runtime AI-delegation gateway that exposes your own registered endpoints to AI agents. This package is for building with Simplr; that one is for delegating your APIs.

Install

Claude Code

claude mcp add simplr-dev -- npx -y @simplr-ai/dev-mcp

To enable the live verification tools, set your API endpoint + credentials:

claude mcp add simplr-dev \
  -e SIMPLR_API_URL=https://api.simplr.sh \
  -e SIMPLR_API_KEY=pk_live_or_sk_live_xxx \
  -- npx -y @simplr-ai/dev-mcp

Point SIMPLR_API_URL at whichever environment you're integrating against — https://api.simplr.sh for production, or http://localhost:7002 for local dev.

Cursor / other clients (mcp.json)

{
  "mcpServers": {
    "simplr-dev": {
      "command": "npx",
      "args": ["-y", "@simplr-ai/dev-mcp"],
      "env": {
        "SIMPLR_API_URL": "https://api.simplr.sh",
        "SIMPLR_API_KEY": "pk_live_or_sk_live_...",
        "SIMPLR_USER_TOKEN": "optional-portal-jwt-for-write-tools"
      }
    }
  }
}

Configuration

Env var	Required for	Description
SIMPLR_API_URL	all live tools	API base URL — set this yourself (e.g. https://api.simplr.sh or http://localhost:7002). There is no baked-in default.
SIMPLR_API_KEY	live read/check tools	A public (pk_*) or secret (sk_*) key.
SIMPLR_USER_TOKEN	live write tools	Portal JWT for create_feature_flag / create_webhook.

The knowledge tools work with no credentials — they ship bundled. The live tools need SIMPLR_API_URL (and a key); the snippets they return also use SIMPLR_API_URL so there's a single knob to point at any environment.

Tools

Knowledge (offline):

• list_features — discover all integrable features.
• get_integration_guide({ feature, language? }) — full step-by-step guide.
• get_code_snippet({ feature, language, snippet? }) — a specific code snippet.
• get_api_reference({ feature }) — raw HTTP surface (method, path, body, response).
• get_quickstart({ features?, language? }) — one combined install + init block.
• search_docs({ query }) — search across all bundled feature content.

Live (need credentials):

• validate_api_key — confirm the key works; report type + environment.
• run_check({ email?, phone?, device?, event_type? }) — run a real fraud/identity check.
• list_flags({ environment? }) — see flag config exactly as the SDK receives it.
• create_feature_flag({ org_id, key, ... }) — scaffold a flag (portal token).
• create_webhook({ org_id, url, events }) — register an event subscription (portal token).

Covered features

email-verification · phone-verification · device-fingerprinting · behavioral-biometrics · order-fraud · edge-logs · mdm · feature-flags · rum (user-flows) · webhooks · journeys (CI) · ai-gateway

Develop

bun install
npm run build      # tsup → dist/
npm run typecheck  # tsc --noEmit
npm run smoke      # spawn server over stdio, list + call tools