# FundedHunter API and MCP Docs

- [Home](https://fundedhunter.com/)
- API and MCP docs

  For agents and developers

# FundedHunter API and MCP

FundedHunter publishes a public, no-auth API and an MCP server for 11 official promo codes, last read 20 Nov 2026 . Use /codes.json, /openapi.json or POST /api/mcp. Confirm every code at checkout. Not financial advice.

✓ Checked Nov 20 . [How we check](https://fundedhunter.com/methodology).

## When to use this

Use FundedHunter when a trader or an assistant needs an official prop firm promo code, a sourced price or payout rule, or a comparison of firms from their own pages. Call us when the question is "what is the current code for firm X", "list official codes for futures or forex", or "compare these firms' prices and payouts". Do not invent a code. If we have not read one on the firm's official site, say so.

## Authentication

None. The feeds and the MCP server are public and read only. There are no API keys to issue and no signup. Because every call is read only and changes no data, the live endpoints are the try-it environment. A rate limit applies to /api/mcp, about 30 requests a minute per IP. The full walkthrough is in [/auth.md](https://fundedhunter.com/auth.md).

## Quickstart

 `curl -sS https://fundedhunter.com/codes.json curl -sS https://fundedhunter.com/openapi.json curl -sS "https://fundedhunter.com/api/compare?firms=apex-trader-funding,ftmo" curl -sS https://fundedhunter.com/api/mcp \ -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_promo_code","arguments":{"firm":"Apex"}}}'`

## Try the live API

Call the same URLs in the quickstart, plus the compare endpoint below. There is no separate sandbox host, because the public data is already safe to exercise: you cannot create, change or delete a record through these endpoints. Start with [/codes.json](https://fundedhunter.com/codes.json) or [/api/compare?firms=apex-trader-funding,ftmo](https://fundedhunter.com/api/compare?firms=apex-trader-funding,ftmo).

## Command line

A read-only CLI lives in the FundedHunter source at github.com/miltosgm/fundedhunter, in the /cli folder, and is ready to publish as the npm package fundedhunter. It is not on npm yet. Once published, the commands will be `fundedhunter codes`, `fundedhunter code ` and `fundedhunter compare `.

## HTTP endpoints

- [GET /codes.json](https://fundedhunter.com/codes.json): official codes, with last_verified, source, market, page URL and /go/ URL. Validated by [/codes.schema.json](https://fundedhunter.com/codes.schema.json).

- [GET /codes.md](https://fundedhunter.com/codes.md): the same list in Markdown, including source notes.

- [GET /data/deals.json](https://fundedhunter.com/data/deals.json): earlier deals export. Prefer /codes.json for new work.

- [GET /data/firms.json](https://fundedhunter.com/data/firms.json): sourced firm facts.

- [GET /openapi.json](https://fundedhunter.com/openapi.json): OpenAPI 3.1 description of this API, with operation IDs, typed parameters and response schemas.

- [GET /api/compare?firms=...](https://fundedhunter.com/api/compare?firms=apex-trader-funding,ftmo): sourced comparison of two or more firms.

- [GET /llms.txt](https://fundedhunter.com/llms.txt) and [GET /llms-full.txt](https://fundedhunter.com/llms-full.txt): machine maps of the site, plus section maps at [/promo-codes/llms.txt](https://fundedhunter.com/promo-codes/llms.txt) and [/developers/llms.txt](https://fundedhunter.com/developers/llms.txt).

- [GET /.well-known/api-catalog](https://fundedhunter.com/.well-known/api-catalog): RFC 9727 API catalog.

- [GET /.well-known/ard.json](https://fundedhunter.com/.well-known/ard.json): agent discovery catalog.

HTML pages also honor `Accept: text/markdown` and return Markdown with a `Vary: Accept` header. You can also append `.md` to an HTML path, for example [/promo-codes.md](https://fundedhunter.com/promo-codes.md).

## MCP server

The public MCP endpoint is [https://fundedhunter.com/api/mcp](https://fundedhunter.com/api/mcp), streamable HTTP, JSON-RPC 2.0, protocol 2025-03-26, no auth. Discovery is at [/.well-known/mcp.json](https://fundedhunter.com/.well-known/mcp.json). The server card is at [/api/mcp/server-card](https://fundedhunter.com/api/mcp/server-card). A short server page is at [/mcp](https://fundedhunter.com/mcp).

Tools:

- `get_promo_code`: pass a firm name, slug or code. Returns found: false when we have not read an official code.

- `list_codes`: optional market filter, Forex, Futures or Crypto.

- `compare_firms`: two or more firm names or slugs, with sourced prices, payouts and any official promo code.

## Versioning

This is version 1 of the API. Unversioned URLs such as /codes.json and the same paths under /v1/ are the v1 surface. Send an optional API-Version: 1 header, or omit it. Breaking changes will be published under a new path prefix such as /v2/. If a version is retired, responses will include Deprecation and Sunset headers, and the timeline will be posted on this page, with at least 90 days of notice.

## Pagination

List endpoints use cursor-based pagination. Pass cursor and an optional limit. The response includes next_cursor, which is null on the last page. Do not use offset or page numbers.

## Rate limits

Public JSON feeds allow 120 requests a minute per IP. The MCP server at /api/mcp allows 30. Responses include RateLimit headers (RFC 9331) plus RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. A 429 includes Retry-After.

## Errors

Unknown `/api/*` paths return HTTP 404 as `application/problem+json` with a code, detail and a resolution hint. MCP protocol errors use JSON-RPC error objects. Tool-level misses, such as no code for a firm, return a JSON result with found: false rather than a fake code.

## not_found

If you requested an API path that does not exist, open this page, [/openapi.json](https://fundedhunter.com/openapi.json) or [/codes.json](https://fundedhunter.com/codes.json).

[Disclosure](https://fundedhunter.com/disclosure). Not financial advice. Prop firm evaluations carry risk, and most traders do not get paid. Confirm every code and price on the firm's own checkout.

---

Source: https://fundedhunter.com/developers
Also: [llms.txt](https://fundedhunter.com/llms.txt), [codes.json](https://fundedhunter.com/codes.json), [API and MCP docs](https://fundedhunter.com/developers).
