@refkitnet/mcp

RefKit MCP server for AI agents - manage affiliate programs, check integration setup, and wire the REST API or JavaScript SDK into your app.

Runs locally over stdio. Talks to the RefKit REST API at https://app.refkit.net.

Install

No global install required. Configure your agent to run:

npx -y @refkitnet/mcp

Or install globally:

npm install -g @refkitnet/mcp
refkit-mcp

Local monorepo development: build and run from repo root:

npm run build:mcp
node packages/mcp/dist/index.js

Authentication

Developers (session): log in once with the RefKit CLI. The MCP reads the same config file.

npx refkitnet auth login

Config is stored at ~/.refkitnet/config.json.

Affiliate tools: set an affiliate API key (rk_aff_...) in the environment, or use a session token from refkitnet auth login.

| Variable | Purpose | |----------|---------| | REFKIT_TOKEN | Override session token | | REFKIT_AFFILIATE_KEY | Affiliate API key for affiliate tools | | REFKIT_API_URL | API base URL (default https://app.refkit.net) |

Cursor

{
  "mcpServers": {
    "refkit": {
      "command": "npx",
      "args": ["-y", "@refkitnet/mcp"]
    }
  }
}

Run npx refkitnet auth login in your terminal first.

For local monorepo development of this package (from repo root after npm run build:mcp), use:

{
  "mcpServers": {
    "refkit": {
      "command": "node",
      "args": ["packages/mcp/dist/index.js"]
    }
  }
}

That is what apps/app/.cursor/mcp.json uses while iterating on the MCP itself.

Claude Code

Add to ~/.claude/settings.json or project MCP config:

{
  "mcpServers": {
    "refkit": {
      "command": "npx",
      "args": ["-y", "@refkitnet/mcp"]
    }
  }
}

Tools

Integration

| Tool | Description | |------|-------------| | get_auth_status | Check auth and login instructions | | get_integration_instructions | Current manual/agent guide links plus optional JavaScript SDK snippets | | get_setup_status | Mode-aware test integration and production readiness status | | create_stripe_connect_link | Stripe Connect onboarding URL | | disconnect_stripe | Disconnect live or test Stripe before switching to API reporting | | list_api_keys | List API keys | | create_api_key | Create app or affiliate key (test_mode=true while integrating) | | revoke_api_key | Revoke a key |

Developer management (session)

Organizations, apps (including publish_app_agreement), programs (including recurring_duration_months and publish_program_terms), affiliates, clicks, referrals, payments, commissions, and ready payouts (including list_ready_payouts and mark_affiliate_payout_paid).

Developer read tools for overview, affiliates, clicks, referrals, transactions, and commissions accept environment: "test" | "live" where the REST endpoint supports mode isolation.

Affiliate (affiliate key or session)

update_app, browse_refkit_network, join_refkit_network_program, list_affiliate_links, list_program_affiliate_links, create_program_affiliate_link, delete_program_affiliate_link, get_payout_balance, request_payout, get_payout_details

Typical agent workflow

1. get_auth_status - confirm logged in
2. get_integration_instructions - get the current REST-first guide and app-stack notes
3. Implement server capture and identify through REST, or use @refkitnet/sdk as an optional JavaScript wrapper
4. create_stripe_connect_link - connect Stripe
5. get_setup_status - verify clicks, identify, and commissions are flowing

Canonical setup guides:

• Manual setup
• AI coding agent setup

License

MIT