StarkFi exposes a production HTTP API at https://api.starkfi.io for StarkPay, yield, orders, and KYC. For teams building with Cursor, Claude Desktop, Claude Code, or any MCP-compatible client, we publish a typed Model Context Protocol surface and agent skills so models call validated tools instead of improvising requests.

This page is the entry map: choose a path, copy the minimum configuration, and link out to the repositories for depth.

flowchart TB
    subgraph inputs["What you have"]
        A[StarkFi API key]
        B[Node.js 20+]
    end

    subgraph paths["Choose your integration path"]
        C["Path A — Guided setup\nCursor · Claude Desktop · Claude Code"]
        D["Path B — MCP only\nAny MCP host"]
        E["Path C — HTTP & docs\nNo MCP"]
    end

    subgraph outputs["Result"]
        F["Skills + MCP registered\nAgents use starkfi tools"]
        G["starkfi-mcp on stdio\nZod-validated tool catalog"]
        H["REST + llms.txt\nGrounded prompts & RAG"]
    end

    A --> paths
    B --> paths
    C --> F
    D --> G
    E --> H

    style inputs fill:#f6f8fa,stroke:#d0d7de
    style paths fill:#fff8f0,stroke:#d0d7de
    style outputs fill:#f0fff4,stroke:#d0d7de

Best for: teams on Cursor and Claude Desktop who want agent skills and MCP wired consistently on developer machines.

The starkfi-agent-skills package copies official Cursor Agent Skills and merges the StarkFi MCP server into host configuration.

CI and automation:

STARKFI_API_KEY="your_key_here" npx starkfi-agent-skills setup --yes

What gets configured

References: GitHub — starkfi-agent-skills · npm — starkfi-agent-skills

Best for: custom agents, IDEs, or platforms that already speak MCP over stdio and only need the StarkFi tool surface.

starkfi-mcp is the published package from starkfi-mcp-agent: TypeScript, ESM, Zod-validated tools, default base URL https://api.starkfi.io (override with STARKFI_BASE_URL).

{
  "mcpServers": {
    "starkfi": {
      "command": "npx",
      "args": ["-y", "starkfi-mcp"],
      "env": {
        "STARKFI_API_KEY": "your_key_here"
      }
    }
  }
}

References: GitHub — starkfi-mcp-agent · npm — starkfi-mcp

Best for: plain HTTP clients, custom LLM stacks, or RAG where MCP is not in scope.

Tools are grouped by prefix; each tool’s MCP description guides when the model should invoke it.

Official SKILL.md bundles teach the agent yield, StarkPay / orders, KYC, and MCP host conventions. They ship with starkfi-agent-skills. Install into .cursor/skills/ so Cursor discovers them automatically.

Treat STARKFI_API_KEY as a production secret. Store it in the MCP host env block, a secure environment, or a secret manager—not in source control.