MCP Connector Docs

MCP connectors

Use Majir inside the AI assistant you already have. Pick yours, sign in once with your email, then ask for deals the way you normally would.

Live

Claude chat

Claude directory

Add Majir from the Claude directory, confirm with a 6-digit email code, and Claude can search deals and read the savings in your Majir wallet.

Claude chat

Coming soon

ChatGPT

ChatGPT apps

Majir for ChatGPT is waiting on OpenAI's approval. This button turns on as soon as it is approved.

ChatGPT

Coming soon

Google A2A

Gemini Enterprise

Majir's Agent2Agent connector for Gemini Enterprise is waiting on Google's approval. This button turns on as soon as it is approved.

Google A2A

1

Choose your assistantOpen the connector for the AI you use.

2

Sign in with a codeWe email you a 6-digit code. No password.

3

Ask for dealsTry "find me a coupon for running shoes".

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

[email protected]

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.