@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 contract procedures that are marked for MCP exposure, 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. Current exposed surfaces include voucher lookup, validation, redemption, campaign lookup, customer lookup, loyalty member history, segment previews, and other procedures explicitly marked for MCP exposure.

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