Skip to content
Back to search

mcp-server

Connect an AI assistant to a Miramarket account: Hyperliquid perps, tokenized stocks on Base and Polymarket over MCP

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/miramarket--mcp-server/badge.svg)](/listings/miramarket--mcp-server)

HTML

<a href="/listings/miramarket--mcp-server"><img src="/api/listings/miramarket--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 121 lines
  1. # Miramarket MCP server
  2. The public connector card for **Miramarket**'s hosted MCP server. Miramarket is a trading account for
  3. three kinds of market from one place: prediction markets on Polymarket, perpetual futures on
  4. Hyperliquid (crypto, stocks, indices, commodities, FX, rates), and tokenized stocks on Base.
  5. An AI assistant connected to this server can look up markets, build a strategy from a plain-English
  6. request, simulate it, and (only if you allow it, and only up to a budget you set) start a live run
  7. with real money.
  8. - **Endpoint:** `https://api.miramarket.org/mcp`
  9. - **Transport:** Streamable HTTP (every answer is an SSE stream, with a keepalive frame every 10s)
  10. - **Auth:** OAuth 2.1 with PKCE (S256), dynamic client registration or a Client ID Metadata Document
  11. - **Docs:** [Connect an AI assistant](https://docs.miramarket.org/mcp-server) ·
  12. [MCP reference](https://docs.miramarket.org/mcp-reference) ·
  13. [Machine-readable reference](https://docs.miramarket.org/mcp-reference.md)
  14. - **Site:** https://www.miramarket.org
  15. The server itself is hosted and closed-source; this repository holds the connection details,
  16. `server.json` for the MCP Registry, and the tool reference so directories and clients have a public
  17. project page to point at.
  18. ## Connect
  19. ```bash
  20. # Claude Code
  21. claude mcp add --transport http miramarket https://api.miramarket.org/mcp
  22. ```
  23. Then type `/mcp` in Claude Code and choose **miramarket**; your browser opens the Miramarket approval
  24. page.
  25. **Claude on the web, desktop and mobile, ChatGPT (developer mode) and Grok** each take the same
  26. address as a custom connector. Any other client that speaks remote MCP over Streamable HTTP with
  27. OAuth sign-in connects the same way.
  28. ```jsonc
  29. // HTTP clients such as Cursor, LibreChat, Open WebUI, FinceptTerminal
  30. {
  31. "mcpServers": {
  32. "miramarket": {
  33. "type": "http",
  34. "url": "https://api.miramarket.org/mcp"
  35. }
  36. }
  37. }
  38. ```
  39. Server metadata for clients that discover authorization:
  40. - Resource metadata: `https://api.miramarket.org/.well-known/oauth-protected-resource/mcp`
  41. - Authorization server: `https://api.miramarket.org/.well-known/oauth-authorization-server`
  42. - Resource to request tokens for: `https://api.miramarket.org/mcp`
  43. ## Scopes
  44. | Scope | Allows |
  45. | - | - |
  46. | `account:read` | Always granted. Read strategies, runs and committed funds. |
  47. | `strategies:write` | Build, validate and save strategies; start and stop simulations. |
  48. | `trade` | Start live runs within the connection's budget, ask the owner to approve ones beyond it, and stop live runs. |
  49. There is no withdrawal scope, and the connection cannot place single orders or bridge funds. The
  50. account owner chooses the scopes and the budget on the approval page and can revoke the connection at
  51. any time from **Connected agents** in the app.
  52. ## Tools
  53. | Tool | What it does | Scope |
  54. | - | - | - |
  55. | `whoami` | This connection's scopes, live budget, how much of it is in use. | none |
  56. | `capital_summary` | Money committed to running strategies and pending withdrawals. | `account:read` |
  57. | `strategies_list` | The account's strategies, newest first, with status and money. | `account:read` |
  58. | `strategy_show` | One strategy's nodes, principal, latest run and app link. | `account:read` |
  59. | `markets_search` | Open Polymarket markets by keyword, with prices, liquidity and volume. | public |
  60. | `markets_by_tag` | Open Polymarket markets under a tag slug, most traded first. | public |
  61. | `perps_list` | Hyperliquid perps by category, with mark price, funding and max leverage. | public |
  62. | `perps_search` | Hyperliquid perps by name or ticker. | public |
  63. | `stocks_list` | Tokenized stocks on Base, with swap price and the price a condition watches. | public |
  64. | `strategy_guide` | How to design a strategy, write its request, or write its JSON. | none |
  65. | `strategy_generate` | Builds a strategy from a description with the same assistant as the app. | `strategies:write` |
  66. | `strategy_generate_status` | Follows a build that answered `working`. | `strategies:write` |
  67. | `strategy_validate` | Checks a strategy JSON with the same validator the app uses. | none |
  68. | `strategy_post` | Saves a strategy as a draft or starts a simulation. No real money moves. | `strategies:write` |
  69. | `strategy_start_live` | Starts a saved draft with real money, within the budget or with the owner's approval. | `trade` |
  70. | `strategy_live_approval` | Where a live start waiting for the owner stands. | none |
  71. | `strategy_cancel` | Stops a run; a live run's open positions close at market. | `trade` / `strategies:write` |
  72. | `withdraw_in_app` | Points the owner to the app, because agents cannot withdraw. | none |
  73. A strategy the assistant builds is shown to you leg by leg (venue, market, side, amount, leverage)
  74. before anything happens. In hosts that render MCP Apps (Claude, ChatGPT) it arrives as an inline
  75. card with **Simulate** and **Run Live** buttons; elsewhere it arrives as a summary and a link that
  76. opens the strategy in the Miramarket builder.
  77. ## Safety boundary
  78. - The agent never withdraws. Withdrawals happen in the app, by the account owner.
  79. - A live run above the connection's budget waits for the owner on **Connected agents**
  80. (`app.miramarket.org/settings/agents`) and expires after a day.
  81. - Only the owner can set or change the budget; the assistant cannot.
  82. - Claude Code asks before every live start and every stop. Other hosts have their own confirmation
  83. settings.
  84. - Simulation (`mode: "demo"`) uses no real funds.
  85. Trading involves risk and leverage magnifies losses. Execution and fills are not guaranteed. Nothing
  86. here is financial, investment, legal or tax advice.
  87. ## Registry
  88. `server.json` publishes this server to the official MCP Registry as
  89. `io.github.miramarket/miramarket`:
  90. ```bash
  91. mcp-publisher validate
  92. mcp-publisher publish
  93. ```
  94. ## License
  95. Documentation in this repository may be read and quoted freely. Miramarket itself is proprietary:
  96. the hosted server, the app and the strategy engine are not distributed here.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.