@perkamo/mcp
v0.3.0
Published
Model Context Protocol server for Perkamo loyalty and gamification operations.
Readme
Perkamo MCP Server
Perkamo MCP exposes loyalty and gamification operations to MCP-compatible clients such as Claude Desktop and Codex.
Hosted OAuth MCP
Use the hosted Perkamo MCP endpoint when your client supports remote MCP servers. No npm package or server API key is required on your machine.
https://api.perkamo.com/mcpClaude and Claude Desktop
For Claude.ai or Claude Desktop, add a custom connector with the hosted URL above. Claude will connect to the remote MCP server and open the Perkamo OAuth flow when you connect the integration.
In Claude Code, add the remote HTTP server from a terminal:
claude mcp add --transport http perkamo https://api.perkamo.com/mcpThen start Claude Code, run /mcp, choose Perkamo and complete the browser
login. Add --scope user if you want the connector available in every project.
Codex
In Codex CLI, add the Streamable HTTP server and authenticate it:
codex mcp add perkamo --url https://api.perkamo.com/mcp
codex mcp login perkamo --scopes mcp:read,mcp:writeUse only --scopes mcp:read for a read-only agent session.
Local stdio adapter
Use the npm package only when your client cannot connect to the hosted remote MCP endpoint, or when you need a private bridge deployment:
npm install -g @perkamo/mcp
PERKAMO_SERVER_API_KEY=sk_test_... \
perkamo-mcpMutating tools require both PERKAMO_MCP_ALLOW_MUTATIONS=true and confirm: true in the tool input.
Core tools include program and usage reads, customer search/detail, trusted identify/event ingestion, batch events, reward redemption, browser token creation, config validation/upload, migration planning and manual customer adjustments.
