MCP Integration Guide
The Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools directly. Flash implements an MCP server so you can manage stores, members, coupons, and points from within Claude Desktop, Cursor, or any MCP-compatible client.
Instead of writing code, you simply ask the AI: "List all active stores" or"Award 500 points to member m_abc123" and the assistant calls the Flash MCP tool on your behalf.
Connection Configuration
Flash exposes a Streamable HTTP MCP endpoint. You need two pieces of information:
| Endpoint URL | https://your-domain.com/api/mcp |
| API Key Header | X-API-Key: flash_sk_... |
Create an API Key at /flash/account/api-keys. Ensure the key has the scopes needed for the tools you plan to use.
Claude Desktop Configuration
Add the following to your Claude Desktop MCP settings (claude_desktop_config.json):
{
"mcpServers": {
"flash": {
"type": "streamable-http",
"url": "https://your-domain.com/api/mcp",
"headers": {
"X-API-Key": "flash_sk_your_key_here"
}
}
}
}Cursor Configuration
In Cursor, go to Settings > MCP and add a new server:
{
"mcpServers": {
"flash": {
"type": "streamable-http",
"url": "https://your-domain.com/api/mcp",
"headers": {
"X-API-Key": "flash_sk_your_key_here"
}
}
}
}Available Tools (13)
list_storesList all stores for the current team. Supports optional status filter, search, and pagination.
status?, search?, limit?, offset?get_storeGet details of a specific store by its ID.
store_idlist_membersList loyalty program members. Supports program filter and pagination.
programId?, limit?, offset?, status?get_memberGet details of a specific loyalty member by ID. Returns decrypted PII fields.
member_idlist_coupon_poolsList coupon pools. Supports status and type filters.
status?, coupon_type?, limit?, offset?get_dashboard_statsGet aggregated dashboard statistics: captures, scans, capture rate, coupons, stores, plan.
(none)earn_pointsAward loyalty points to a member. Returns transaction ID and new balance.
member_id, amount, description?redeem_pointsDeduct loyalty points from a member (FIFO consumption).
member_id, amount, reasonget_points_balanceGet member's current points balance and recent transaction history.
member_id, limit?get_member_couponsGet a member's available (unredeemed, unexpired) coupons.
member_idget_member_tierGet member's current tier, next tier upgrade requirements, and all tiers.
member_idget_member_receiptsGet member's receipt submission history with OCR status and points awarded.
member_id, limit?redeem_points_for_couponRedeem loyalty points for a coupon from a specified pool.
member_id, pool_id, points_costExample Conversation
list_stores with status="active"