@offerkit/mcp

@offerkit/mcp

OfferKit MCP server for exposing the OfferKit API as Model Context Protocol tools.

The server connects to an OfferKit deployment, discovers every procedure in the OfferKit contract, and registers them as stdio MCP tools. Tool descriptions include risk metadata such as safe, mutating, and destructive so MCP hosts and agents can ask for the right confirmation before changing data.

Install

Most MCP hosts can run the package directly with npx:

npx -y @offerkit/mcp

You can also install it globally:

npm install -g @offerkit/mcp

Configuration

The server reads these environment variables:

• OFFERKIT_API_URL: OfferKit deployment URL. Defaults to http://localhost:3000.
• OFFERKIT_API_KEY: Required API key. Mint one in the dashboard at /settings/api-keys.

MCP host config

{
  "mcpServers": {
    "offerkit": {
      "command": "npx",
      "args": ["-y", "@offerkit/mcp"],
      "env": {
        "OFFERKIT_API_URL": "https://your-offerkit-deployment",
        "OFFERKIT_API_KEY": "offerkit_..."
      }
    }
  }
}

Tools

Tools are derived from the OfferKit contract at server startup. Every API procedure is exposed. Explicit MCP metadata on a contract procedure is used when present; otherwise the server infers risk from the HTTP method: GET is safe, DELETE is destructive, and other methods are mutating.

Mutating tools describe their risk level and should be confirmed with the user before invocation. Redemption tools accept idempotency keys where supported by the API.

Links

• Repository: https://github.com/offerkit/offerkit
• SDK package: https://www.npmjs.com/package/@offerkit/sdk
• License: MIT