MCP server

Give an AI agent its own seat at the market. Connect majjha to Claude, ChatGPT or Cursor over the Model Context Protocol and your agent can read markets and trade — straight from the chat.

Hosted server — preview

The hosted endpoint https://mcp.majjha.com/mcpwith browser sign-in is rolling out. The connection details below are final; this page will note when it's live.

Connected to the play site

majjha runs two environments — a free play-money site and a real-money site. The hosted MCP server acts on your play account: same login, play-money balance, nothing at stake. A live-site server will follow when real-money trading is generally available.

How it works

majjha runs a remote MCP serverover the streamable HTTP transport. You don't manage an API key — the first time a client connects, you sign in to your majjha account through OAuth, approve the scopes, and that's it. The client keeps the session; tools act on your account.

No API key to copy, paste or rotate — just sign in once.
Works with any MCP client that speaks streamable HTTP: Claude (Web & Code), ChatGPT, Cursor, Windsurf, VS Code, Codex…
You choose what to grant: read only, or read + trade.

Getting started

1. Have a majjha account

Any account works. MCP tools trade on the same balance as the app.

2. Add the server

Add https://mcp.majjha.com/mcp in your AI client's MCP settings.

3. Approve the sign-in

4. Start trading

Ask your assistant to find markets, check books, or place a trade.

Server endpoint

The majjha MCP server lives at:

Streamable HTTP

https://mcp.majjha.com/mcp

It uses the streamable HTTP MCP transport, so any modern client connects directly — no local bridge to install.

Authentication

majjha MCP uses OAuth 2.1 with your majjha account. The first time a client connects it opens a browser window to sign in and approve access; after that the client keeps the session. Clients discover the OAuth configuration through standard well-known URLs and pick them up automatically:

Resource	URL
Protected resource metadata	https://mcp.majjha.com/.well-known/oauth-protected-resource
Authorization server metadata	https://mcp.majjha.com/.well-known/oauth-authorization-server

Two scopes are offered at sign-in: read (markets & your portfolio) and trade(place & cancel orders). Grant only what you need.

Connect your client

Every client asks for the same details: name majjha, URL https://mcp.majjha.com/mcp, authentication OAuth.

Claude Code

one command

claude mcp add --transport http majjha https://mcp.majjha.com/mcp

The first call opens the OAuth flow in your browser. Approve it and the tools are live.

Cursor

Settings → MCP → Add new global MCP server, then paste:

~/.cursor/mcp.json

{
  "mcpServers": {
    "majjha": {
      "url": "https://mcp.majjha.com/mcp"
    }
  }
}

Claude Web & ChatGPT

Claude Web: Profile → Customize → Connectors → Add custom connector → name majjha, URL https://mcp.majjha.com/mcp, finish the OAuth sign-in.
ChatGPT: Settings → Advanced → Developer mode → Apps → Create → name majjha, URL https://mcp.majjha.com/mcp, choose OAuth.

Other clients (Windsurf, VS Code, Codex…) follow the same idea: add https://mcp.majjha.com/mcp as a streamable HTTP server and finish the OAuth sign-in.

Tools

The server exposes these tools. The live tools/list response is always the source of truth.

Market data

— Public reads — available to any connected client.

get_exchange_statusCheck the exchange is operational.
list_marketsList/search markets by status, category or text.
get_marketFetch a single market by ticker.
get_orderbookCurrent bids/asks, spread and mid for a market.
get_market_tradesRecent public trades for a market.
list_seriesList recurring market families (series).
list_eventsList events, optionally within a series.

Trading & portfolio

— Act on your account — require the trade scope you grant at sign-in.

get_balancetrade / portfolioCash balance and total portfolio value.
list_positionstrade / portfolioOpen positions with value and P&L.
list_orderstrade / portfolioYour orders, filterable by ticker/status.
place_ordertrade / portfolioPlace a limit order (yes/no, buy/sell).
cancel_ordertrade / portfolioCancel an order's remaining quantity.

FAQ

Do I need an API key?

No — you sign in once with OAuth and the client keeps the session. There's nothing to manage or rotate.

Which agents are supported?

Any MCP client that supports streamable HTTP: Claude (Web & Code), ChatGPT, Cursor, Windsurf, VS Code, Codex, and more.

Can an agent really place trades?

Yes, if you grant the trade scope. Orders use your account balance. Grant read-only if you just want analysis.

How do I revoke access?

Revoke the connection from your majjha settings (or your MCP client). Tokens can be invalidated server-side.

PreviousWebSocket Next Specifications