4dlivetoday MCP Server

4D Results API & MCP Server — 4dlivetoday

Official 4D lottery results for Malaysia, Singapore and Cambodia, as a free JSON API and a remote MCP server that AI assistants (Claude, ChatGPT, Cursor and others) can query directly.

• MCP server: https://4dlivetoday.com/mcp (Streamable HTTP, no sign-in)
• REST API: https://4dlivetoday.com/api/v1/ (JSON, no key)
• Docs page: https://4dlivetoday.com/en/developers
• Data licence: CC BY 4.0 — free to use, including commercially, with attribution

Results are compiled from each operator's own official website and cross-checked where a second source exists. This service publishes results and draw history only. It does not sell tickets or accept bets, and it offers no number recommendations, "hot" numbers or forecasts.

---

Contents

• What's covered
• Use it from an AI assistant (MCP)
• MCP tools
• REST API
• Response format
• Errors
• Fair use and caching
• Attribution
• Data quality
• Licence

---

What's covered

Every 4D draw has 23 numbers: 1st, 2nd and 3rd prize, 10 special (starter) and 10 consolation.

Other official games (game ids):

History: 4D results go back decades (Magnum from 1985). Magnum and Da Ma Cai other games cover the last 12 months and grow daily; Sports Toto games and Singapore Toto are kept from late September 2026 onward.

Draw days and times: see https://4dlivetoday.com/en/schedule (or the get_draw_schedule tool).

---

Use it from an AI assistant (MCP)

The server speaks Streamable HTTP at:

https://4dlivetoday.com/mcp

No API key and no OAuth.

Claude (claude.ai and Claude Desktop, via connectors)

Settings → Connectors → Add custom connector → paste https://4dlivetoday.com/mcp.

Claude Desktop (config file, via mcp-remote)

claude_desktop_config.json:

{
  "mcpServers": {
    "4dlivetoday": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://4dlivetoday.com/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http 4dlivetoday https://4dlivetoday.com/mcp

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "4dlivetoday": { "url": "https://4dlivetoday.com/mcp" }
  }
}

VS Code

.vscode/mcp.json:

{
  "servers": {
    "4dlivetoday": { "type": "http", "url": "https://4dlivetoday.com/mcp" }
  }
}

Try it

Ask your assistant things like:

• "What were last night's Magnum 4D results?"
• "Show me every operator's 4D results for 27 September 2026."
• "Has 1063 ever won a prize? When?"
• "What's the latest Supreme Toto 6/58 result and jackpot?"
• "When is the next Singapore 4D draw?"

Ready-made config files are in examples/mcp.

---

MCP tools

Every tool result includes a short text summary plus the full structured data, and each result carries a url to the matching page on 4dlivetoday.com so the assistant can link to it.

---

REST API

Base URL: https://4dlivetoday.com/api/v1

Examples

curl https://4dlivetoday.com/api/v1/latest
curl https://4dlivetoday.com/api/v1/results/2026-09-27
curl "https://4dlivetoday.com/api/v1/operators/magnum?limit=5"
curl https://4dlivetoday.com/api/v1/numbers/1063
curl "https://4dlivetoday.com/api/v1/games/sg_toto?limit=3"
curl https://4dlivetoday.com/api/v1/schedule

More in examples/: curl, Python, Node.js.

CORS is open (Access-Control-Allow-Origin: *), so you can call it from a browser.

---

Response format

Every successful response has the same envelope (url is the matching human-readable page on 4dlivetoday.com):

{
  "data": { "results": [ ] },
  "source": "4dlivetoday.com",
  "license": "CC BY 4.0",
  "license_url": "https://creativecommons.org/licenses/by/4.0/",
  "attribution": "Results from 4dlivetoday.com (https://4dlivetoday.com), compiled from each operator's official site.",
  "url": "https://4dlivetoday.com/en/results/2026-09-27",
  "generated_at": "2026-09-30T12:00:00.000Z"
}

What data holds per endpoint:

A 4D draw (real, trimmed):

{
  "operator": "magnum",
  "operator_name": "Magnum 4D",
  "date": "2026-09-27",
  "draw_no": "428/26",
  "first": "1063",
  "second": "2421",
  "third": "5815",
  "special": ["6814", "7902", "… 10 numbers"],
  "consolation": ["1091", "8204", "… 10 numbers"],
  "status": "checked",
  "url": "https://4dlivetoday.com/en/results/2026-09-27"
}

Numbers are always strings, so leading zeros are kept ("0650", never 650).

status tells you how far a result has been verified:

A game result (real, trimmed):

{
  "game": "sg_toto",
  "game_name": "Singapore Toto",
  "operator": "sg",
  "date": "2026-09-28",
  "draw_no": "4221",
  "numbers": ["14", "22", "25", "27", "34", "37"],
  "bonus": ["18"],
  "jackpots": { "Group 1 prize": "S$ 1,298,326" },
  "url": "https://4dlivetoday.com/en/sg-toto"
}

Money amounts are strings exactly as the operator published them, with currency ("RM 12,749,753.62", "S$ 1,298,326"). draw_no can be empty for operators that don't publish a readable draw number.

---

Errors

{ "error": { "code": "invalid_date", "message": "date must be a real calendar date in YYYY-MM-DD format" } }

A date with no draws (for example a regular Monday for the weekly operators) is not an error: it returns 200 with an empty list.

In MCP, the same problems come back as a tool result with isError: true and the same message.

---

Fair use and caching

• No key and no sign-up. Responses are cached for about 60 seconds; results change only around draw times, so please cache on your side too.
• Unknown query parameters are dropped with a redirect to the canonical URL.
• The MCP endpoint accepts one request per call (no JSON-RPC batches).
• Draw nights (roughly 18:30–21:30 Malaysia time on draw days) are when results change; polling more often than once a minute gains nothing.
• Abusive traffic may be rate-limited without notice.

---

Attribution

The data is licensed CC BY 4.0. If you show or republish it, credit:

Results from 4dlivetoday.com, compiled from each operator's official site.

A link back is appreciated and is how this stays free.

---

Data quality

• Every result comes from the operator's own official site. Where a second independent source exists, the result is cross-checked and its status becomes checked.
• Always treat the operator's own announcement as final. If you find a result that differs from the operator's official site, please open an issue with the date, operator and the operator's page.

---

Licence

• Data returned by the API and MCP server: Creative Commons Attribution 4.0 International (CC BY 4.0). See DATA-LICENSE.md.
• Code and documentation in this repository: MIT.

4dlivetoday is an independent results site. It is not affiliated with any operator named above; operator names are used only to identify their results. For readers aged 21 and over, where the law allows.