HTTP Streamable HTTP AUTH API key and OAuth DIR Listed in the Claude directory

MCP Connector

Connect AI assistants to Majir offers through the hosted Model Context Protocol server. Endpoint: https://mcp.majir.shop/mcp

Connection Details

Use the global catalog tools with your Rewards API key or an OAuth session, and use OAuth to let signed-in users search and redeem their own inbox and wallet offers. An OAuth session sees the tools it can use; redeem_offer is available to API-key clients only.

MCP URL

https://mcp.majir.shop/mcp

Transport

Stateless Streamable HTTP

Resource

https://mcp.majir.shop/mcp

Support

hello@majir.shop

Quickstart

MCP clients must send both JSON and event-stream accept headers for Streamable HTTP compatibility. GET /mcp intentionally returns 405; use JSON-RPC POST requests.

POST /mcp

Required headers

Accept application/json, text/event-stream

Required by Streamable HTTP clients.

Content-Type application/json

All MCP requests use JSON-RPC request bodies.

Authorization Bearer token

Use your own Rewards API key (the mjr_live_ key from Get an API key) for catalog tools, or an OAuth token for personal wallet tools. It is the same key as the REST API, sent here as a Bearer token instead of X-Majir-API-Key.

cURL

curl https://mcp.majir.shop/mcp \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_MAJIR_API_KEY' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"example","version":"1.0.0"}}}'

Authentication

Majir separates the public affiliate catalog from a signed-in user's personal inbox and wallet offers.

API key

Global catalog tools

Use your own Rewards API key in Authorization: Bearer. OAuth sessions can also read the catalog tools. These tools search the public/affiliate catalog and never search a user's inbox.

OAuth

Personal wallet tools

Use OAuth to let a signed-in user search only their own Majir inbox and wallet offers. Tokens are scoped to the MCP resource https://mcp.majir.shop/mcp.

Protected resource

GET https://mcp.majir.shop/.well-known/oauth-protected-resource/mcp

resource: https://mcp.majir.shop/mcp
authorization_servers:
  - https://mcp.majir.shop/

Tool Surface

Every tool declares its title, description, and read/write annotation. An OAuth-connected assistant (for example, Claude with the Majir connector) sees the tools its session can use.

Tool	Auth	Annotation	Use when
`search_offers`	API key or OAuth	Read-only	Search global catalog deals, promo codes, cashback, discounts, or better prices.
`get_offer`	API key or OAuth	Read-only	Get details for one global catalog offer returned by search.
`redeem_offer`	API key only	Idempotent write	Return a Majir-tracked redemption URL for a selected global offer; coupon codes come from the offer itself.
`list_my_offers`	OAuth	Read-only	List the signed-in user's saved offers, credits, gift cards, or expiring deals.
`search_my_offers`	OAuth	Read-only	Search only the signed-in user's Majir inbox and wallet offers.
`get_my_offer`	OAuth	Read-only	Get details for one personal wallet offer.
`redeem_my_offer`	OAuth	Idempotent write	Return a Majir-owned tracked redemption URL for a personal offer; it records the redemption attempt.