MCP server

Claude and other MCP (Model Context Protocol) clients can work with ReceiptRoller sales, products, orders, inventory, reservations and social media. Tools call the API as the connected user, within the scopes that user approved.

Connection

Endpoint
https://mcp.receiptroller.io/mcp
Transport
HTTP POST (JSON-RPC 2.0), protocol version 2025-03-26
Authentication
OAuth 2.0 authorization code with PKCE (S256). Dynamic client registration (RFC 7591) is supported, so no client ID has to be issued in advance.
Metadata
https://mcp.receiptroller.io/.well-known/oauth-protected-resource
https://mcp.receiptroller.io/.well-known/oauth-authorization-server

Scopes

The scopes a client can request. Tools call the API with the user's access token, so an operation that needs a scope the user did not approve returns 403.

sns.content.read sns.content.write sns.audience.read analytics.read sales.read store.products.read store.products.write store.orders.read store.orders.write store.inventory.read store.inventory.write store.reservations.read store.memberships.read store.passes.read

Tools

tools/list returns the current list with input schemas.

Account

List business accounts and stores to find the organizationId and storeId other tools take.

  • list_my_organizations
  • list_my_stores

Sales analytics

KPIs, trends, forecasts, top products, visitor analysis, churn risk, store comparison and advice.

  • sales_get_kpis
  • sales_get_trend
  • sales_get_forecast
  • sales_get_top_products
  • sales_get_visitor_analysis
  • sales_get_churn_risk
  • sales_get_customer_recommendations
  • sales_compare_stores
  • sales_get_advice

Social media

Create, schedule and publish posts on connected accounts; analytics and comments.

  • sns_list_accounts
  • sns_get_account
  • sns_list_recent_posts
  • sns_get_post
  • sns_create_post
  • sns_update_post
  • sns_attach_media_from_url
  • sns_schedule_post
  • sns_publish_post
  • sns_delete_post
  • sns_get_analytics
  • sns_list_comments

Products

List, read, create and update products.

  • pim_list_products
  • pim_get_product
  • pim_create_product
  • pim_update_product

Orders

List and read orders, change their status and ship them.

  • oms_list_orders
  • oms_get_order
  • oms_transition_order
  • oms_ship_order

Inventory

Locations, stock levels and movements, and stock adjustments.

  • wms_list_locations
  • wms_get_stock
  • wms_list_movements
  • wms_adjust_stock

Reservations and members

Reservations, slots, statistics, members and pass holders. Read only.

  • reservation_list
  • reservation_list_slots
  • reservation_get_stats
  • reservation_get_analytics
  • membership_list_members
  • pass_list_holders

For store owners, the overview and connection steps are on the AI agent page