Skip to content

docs: [ai] add Jupiter Trading MCP page#925

Open
0xYankee-Raccoons wants to merge 8 commits into
mainfrom
feat/ai-trading-mcp
Open

docs: [ai] add Jupiter Trading MCP page#925
0xYankee-Raccoons wants to merge 8 commits into
mainfrom
feat/ai-trading-mcp

Conversation

@0xYankee-Raccoons

Copy link
Copy Markdown
Collaborator

Summary

Adds a documentation page for the hosted Jupiter Trading MCP server (https://mcp.jup.ag) in the AI section. The server exposes 47 tools across 8 domains and lets AI agents execute Jupiter trades and DeFi operations over the Model Context Protocol. The page covers capabilities, API-key auth, client setup, and example prompts. A findings report cross-checking the MCP against our current docs is included.

Changes

  • New ai/trading-mcp.mdx — capability table (8 domains), Get-an-API-key, client setup tabs (Claude Desktop, Claude Code, Cursor, Windsurf), authentication, example prompts, resources.
  • Edit ai/index.mdx — wire the existing "Jupiter MCP" overview card to /ai/trading-mcp (was "Coming soon").
  • Edit docs.json — add ai/trading-mcp to the AI nav group.
  • Regenerated llms.txt.
  • New jup-mcp-findings.md (repo-root working doc, not in nav / not published) — cross-check of the MCP source vs current docs.

Findings highlights (see jup-mcp-findings.md)

  • Server is live at https://mcp.jup.ag (issue's api.jup.ag/mcp 404s); the "Blocked" status is stale.
  • 47 tools / 8 domains confirmed, but Prediction = 20, not 19.
  • One staleness flag: Trigger tools call the unmaintained /trigger/v1/* API (flagged for the MCP team). Price v3, Swap v2, Tokens v2 are all current.
  • Issue description corrections applied: Lend is Earn-only and not marginfi; Tokens has no "validate addresses" tool; DCA is the Recurring domain, not Trigger.
  • Docs gap surfaced: Recurring per-cycle (50 USD) / min-cycle (2) minimums aren't in our docs — noted as a follow-up.

Linear Issues

  • Fixes DEV-480 — [AI] Add Jupiter Trading MCP documentation page

Checklist

  • node generate-llms-from-docs.js run
  • mint broken-links passes
  • All pages have title, description, llmsDescription
  • docs.json navigation updated
  • Redirects added (n/a — no path changes)
  • Changelog entry (n/a — docs page for an existing server, no API/product change)
  • .claude/rules/ — no new learnings beyond the findings report (Trigger-V1 / recurring-minimum facts captured in jup-mcp-findings.md)

Document the hosted Jupiter Trading MCP server (mcp.jup.ag): 47 tools
across 8 domains, Bearer-token auth, and setup for Claude Desktop,
Claude Code, Cursor, and Windsurf. Wire it into the AI nav and the
AI overview card. Include a findings report cross-checking the MCP
against current docs.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 30, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Jupiter 🟢 Ready View Preview Jun 30, 2026, 10:55 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Re-confirmed all findings against live endpoints and source. Add F3:
the jup-mcp README links portal.jup.ag (redirects to docs root) instead
of developers.jup.ag/portal.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Inbound auth accepts only Authorization: Bearer; suggest also accepting
x-api-key for consistency with the rest of Jupiter's API surface.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Ran the MCP protocol against mcp.jup.ag: handshake, auth gating,
tools/list (47 tools, live matches source), input validation, and
MCP->Jupiter wiring all confirmed. Happy-path price call needs a real key.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
price_get with a valid key returned live SOL/USDC prices over the live
server. Full MCP -> Jupiter path now verified end to end.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Verified the documented Claude Code setup as a user would: claude mcp add
connects, and a headless agent answered a natural-language price query by
auto-discovering and calling the Jupiter MCP tools.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Exercised all 8 domains read-side and completed a real on-chain swap
(0.01 SOL -> USDC) through swap_get_order -> sign -> swap_execute_order.
Add F5 (prediction_list_events oversized payloads) and F6 (short
blockhash validity; sign+submit immediately).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread ai/trading-mcp.mdx Outdated
Comment thread ai/trading-mcp.mdx
Comment thread ai/trading-mcp.mdx Outdated
Comment thread ai/trading-mcp.mdx Outdated
Comment thread ai/trading-mcp.mdx Outdated
Comment thread ai/trading-mcp.mdx Outdated
Comment thread ai/trading-mcp.mdx Outdated
Comment thread ai/trading-mcp.mdx Outdated
Comment thread llms.txt Outdated
Comment thread jup-mcp-findings.md Outdated
Comment thread jup-mcp-findings.md Outdated
Comment thread jup-mcp-findings.md Outdated
Comment thread jup-mcp-findings.md
Comment thread jup-mcp-findings.md Outdated
Comment thread jup-mcp-findings.md Outdated
…gger v2

Re-verified against the live server. Update the Trading MCP page and
findings report: 75 tools across 11 domains (add Send, Studio,
Transaction), API key now optional (keyless works at lower rate limit,
401 = invalid key), and Trigger migrated to /trigger/v2 with the new
challenge -> verify -> deposit -> create_order flow. Regenerate llms.txt.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@0xYankee-Raccoons

Copy link
Copy Markdown
Collaborator Author

Thanks @rluque8 — all addressed in 5e299884. Re-verified against the live server (tools/list) rather than the old source, so the numbers are current:

  • 75 tools across 11 domains — added Send (4), Studio (4), Transaction (1); updated Lend 7→11, Tokens 4→7, Prediction 20→27, Trigger 5→10. Frontmatter, domains table, llms.txt, and the findings inventory all updated.
  • API key is optional — reworded the intro, the (renamed) "API Key (Optional)" section, the Connect/Authentication sections, and the resources card. Confirmed keyless tools/list and price_get both return 200. Config examples note you can drop the headers block to run keyless.
  • 401 = invalid key, not a missing header — fixed the auth bullet and the troubleshooting tip.
  • Trigger is on /trigger/v2 — the example prompt now uses trigger_get_challengetrigger_verify_challengetrigger_build_deposittrigger_create_order; removed the gone trigger_build_order. In the findings, F1 is marked resolved and the version table + inventory reflect v2.

Resolved the threads. Let me know if I missed anything.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants