Duoly
尋找經過排名驗證的遊戲隊友與教練,比較場次價格並準備預約連結。公開工具無需帳戶。付款仍在 duoly.gg 上進行。
託管 MCP 伺服器
npx add-mcp 'https://duoly.gg/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Connect your assistant to Duoly
Use the Duoly MCP server to discover gaming teammates and coaching, calculate a quote and prepare a booking link. Catalog tools are public. Order status needs a private per-order code. All tools are read only. Payment stays on duoly.gg.
Available. Public tools are read only.
How do you connect to the Duoly MCP server?
The Duoly MCP server is a stateless Streamable HTTP endpoint. Connect to https://duoly.gg/mcp using an MCP client, without a Duoly account or OAuth flow. The endpoint accepts one JSON-RPC message per POST and returns JSON. GET and DELETE return 405; batches, subscriptions and streams are unsupported. Send Content-Type: application/json and Accept: application/json, text/event-stream.
Choose one of the three supported revisions before sending tool calls. A client on 2025-11-25 initializes, lists tools and then sends the negotiated MCP-Protocol-Version header. No session ID is issued. The 2025-06-18 revision follows the same initialization path. For 2026-07-28, start with server/discover instead. Every modern request needs matching Mcp-Method and MCP-Protocol-Version headers, plus Mcp-Name for a tool call. Put protocol version, client info and capabilities in params._meta. An SDK from Anthropic or another MCP client must match the selected protocol revision.
Which Duoly MCP tool should a client call first?
find_session is the tool to call first, because a goal plus a game returns up to three priced services with booking links in one round trip. The whole path from a question to a checkout page is three calls.
find_sessionwith a goal and a game.get_quotefor one exact selection.create_booking_linkfor the page a person pays on.
A Valorant coaching search comes back with the VOD Review and its hourly rate. Use the returned missingInputs to ask about rank, region or edition before requesting an exact price. list_games and list_services exist for browsing, while get_availability reports public online counts without reserving anybody. Goal tokens are duo, coaching, ranked, casual and teams, with training and other accepted as category aliases. Each result has one readable summary and full schema-validated structuredContent, without JSON duplicated into text. Card-only data stays in result metadata.
What does a Duoly booking link carry?
A Duoly booking link is a prefilled selection on duoly.gg rather than an order. Share bookUrl as the primary link so a person can book. The link preserves supplied rank, region and quantity, plus role, coaching character, voice, mood and teammate count. Minecraft links also preserve server or world and edition. This Valorant VOD Review booking link is exactly what create_booking_link returns, and it opens the checkout with the service already chosen. The Valorant teammate hub is the human version of the same catalog entry.
A well-behaved client keeps three things straight. Use the exact game, rank and region tokens the catalog returned, and call list_services for the role and seat options. Remember that an availability signal or a quote creates no order, so reach for get_quote only once a service is selected and for create_booking_link only to produce the final link. Leave private notes, in-game names and payment choices on Duoly, where the person confirms what is left. Rank-priced services show a from price and a typical one-unit price; an exact quote has the applicable quantity discount already in it.
What are the inputs and outputs of each tool?
Each Duoly tool takes catalog tokens and returns structured data plus a booking URL. List_games needs nothing, while list_services and create_booking_link need a game. Get_quote needs a game, a service, a server, a quantity and a currency, plus a rank when the service is rank priced. Coaching returns its flat hourly rate; five-unit non-coaching selections receive 20% off. Find_session takes the same selection loosely, filling gaps with a labelled from price and a missingInputs list. get_order_status needs only the private dos_ code, and returns acceptance, teammate display names and a next step. For example, a find_session call for a Valorant duo under five euros returns services, prices and a bookUrl in one structured result, ready to render using Claude cards.
Which inputs does each Duoly MCP tool accept?
The v1 tool reference below is the authoritative input and output list, matching the live schema. Required fields differ by tool: browsing needs fewer choices than an exact quote. Treat missingInputs as a request for clarification, and surface tool errors before rendering a price. On narrow screens, scroll the table.
| Tool | Inputs | Output |
|---|---|---|
list_games | None | games: id, slug, name, bookUrl, url; canonical catalog url. Social is excluded. |
list_services | game (required) | game, services (id, name, description, fromPrice, category, unit, ranks, regions, editions, requiredInputs, bookUrl, url), url. |
find_session | game (required); goal or category, rank, region or server, quantity, budget, currency (EUR or USD), edition (optional) | Up to three matching services with descriptions, real calculated prices, bookUrls and missingInputs. Start here for a teammate or coach. Incomplete selections have labelled from prices. |
get_quote | game, service, quantity (integer 1 to 5), currency (EUR or USD), server (required); rank and edition (Java or Bedrock) when the service requires them | kind, basis, notReserved, currency, amountMinor, amountEurMinor, formattedPrice, unit, quantity, quotedAt, fx, notice, bookUrl, url. Base price before account perks. |
get_availability | game (optional) | game (optional), positive online counts when available, onlineByGame, bookUrl, label, readAt, cacheSeconds, notice, url; medianMatchSeconds, medianWindowDays and medianScope when available. No reservation. |
get_order_status | token (required): the private dos_ code generated in your order room | One order status, game, service, quantity, current acceptance, teammate display names, team seat progress, nextStep and updatedAt. Revocable, read only and limited to this order. |
create_booking_link | game (required); service (optional) | bookUrl, url, notice. Selects the game and optional service. No order is created. |
How accurate are availability and quote results?
An availability result is a cached public signal, and a quote is a calculation. Neither one holds anything. Treat an online count as an upper bound, because a listed teammate may already sit in a session, and request a fresh quote whenever the game, service, rank, quantity or currency changes. Quantity discounts land in the total, never in a from price, so a five-game duo total already has its discount applied while a single coaching hour has nothing to discount. A quote reserves no capacity and locks no amount at checkout.
Availability uses a 30-second cached aggregate. Online counts can include teammates already in a session. Counts are shown only when positive. Zero and unavailable counts are omitted, as are overall totals. Any historical match median covers sitewide accepted orders from the last 30 days, including services outside this catalog. It does not predict a wait time for a game.
Which inputs change a Duoly quote?
A Duoly quote is calculated from game, service, rank, quantity and currency. The service decides the unit: one game and one hour are different purchases. Rank changes rank-priced teammate services, while flat-priced services reject a rank token. For example, Valorant VOD Review is €12.99 per hour at every rank, and takes no rank token at all. Coaching has no quantity discount either.
The ordinary quantity picker accepts one to five units; five non-coaching units receive 20% off. The separate Bundles tab on Duoly sells the main service in packs of three, five or ten, with 10%, 20% and 25% discounts. Do not assume every service accepts a ten-unit quote. Request a fresh result after a selection changes. Checkout recalculates the final price, including applicable account eligibility. Keep currency beside the amount, calculate with amountMinor and retain quotedAt plus FX information. USD quotes are estimates, so a saved conversation answer should never become a checkout promise.
Which service and rank tokens are valid?
A valid token is a string list_services returned for that game, never a display name typed by hand. Use the exact rank and region tokens from list_services, and omit rank entirely for flat-priced services. A service appears only when Duoly actually sells it in that game, so a missing service is an answer about the catalog and not a bug. Valorant coaching is flat priced, which is why a rank token on that service is rejected. Minecraft requires a server or world string and a Java or Bedrock edition. Dynamic streamer bookings are excluded. list_services includes catalog descriptions and a calculated from price in EUR for one game or hour. find_session returns up to three matching services, a total price for the requested quantity and missingInputs. Incomplete selections have labelled from prices; unspecified quantity and currency use one unit and EUR for that preview. A budget is a total cap and needs a currency before it is applied. Goal tokens are duo, coaching, ranked, casual and teams; training and other are category aliases.
How do you request a quote over JSON-RPC?
A quote request is a single tools/call message naming get_quote and a complete selection. The example below uses protocol 2025-11-25 after initialization, so discover valid service and rank values with list_services first.
- List the services for the game.
- Pick a service token and a rank token from that list.
- Send the call itself.
The Platinum Valorant Duo Pro request below returns a formatted price, an amount in minor units and a booking URL. The same call for a Valorant coaching hour carries no rank at all.
Request
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "get_quote",
"arguments": {
"game": "val",
"service": "duo2",
"rank": "Platinum",
"server": "EU",
"quantity": 1,
"currency": "EUR"
}
}
}
Response
A successful call returns MCP content and structured quote data. The response below is a real one, recorded on 7 November 2026. The shape is what your client will receive; the amount moves with the catalog and the exchange rate, so request a fresh quote before booking instead of caching the figure.
{
"result": {
"content": [
{
"type": "text",
"text": "EUR 7.99 total for 1 game; EUR 7.99 per game. Base price before account perks. No reservation. https://duoly.gg/?game=val&service=duo2&agent=claude&rank=Platinum®ion=EU&qty=1#modes-h"
}
],
"structuredContent": {
"kind": "preview",
"basis": "base price before account perks",
"notReserved": true,
"currency": "EUR",
"amountMinor": 799,
"amountEurMinor": 799,
"perUnitMinor": 799,
"savingMinor": 0,
"bundleDiscountPercent": 0,
"formattedPrice": "€7.99",
"unit": "game",
"quantity": 1,
"quotedAt": "2026-11-07T11:03:03.938Z",
"fx": {
"rate": 1.1165,
"source": "ecb",
"date": "2026-11-06",
"fetchedAt": 1794049003630
},
"notice": "Base price before account perks. USD is an estimate. Final payment and any account perks are reviewed on duoly.gg. No teammate is reserved.",
"bookUrl": "https://duoly.gg/?game=val&service=duo2&agent=claude&rank=Platinum®ion=EU&qty=1#modes-h",
"url": "https://duoly.gg/games/valorant"
}
},
"jsonrpc": "2.0",
"id": 2
}
Handle tool errors before showing a price or link. Do not treat an error message, stale quote or empty availability result as a confirmed session.
How do you test a Duoly integration locally?
MCP Inspector is the fastest way to test a Duoly integration without writing a client.
- Start the Inspector locally and open the printed URL.
- Connect using Stateless Streamable HTTP with the endpoint above and no authentication.
- Initialize, list the tools, then try a catalog request before a quote.
A list_services call for Valorant comes back with the coaching hour and its price, which tells you in one request that the connection works and that real figures are arriving. Follow it with a five-game teammate quote to see a quantity discount applied. An unexpected 405 means a GET or DELETE reached the endpoint, since only POST carries a JSON-RPC message. The command line form below prints the tool list without a browser.
npx @modelcontextprotocol/inspector
For a command-line discovery check:
npx @modelcontextprotocol/inspector --cli https://duoly.gg/mcp --transport http --method tools/list
What are the Duoly MCP rate limits?
A Duoly rate limit is a per-IP budget measured in accepted POST requests, including discovery and initialization. Respect both the per minute and the per day caps listed below, because every accepted request counts against them. Back off on HTTP 429 using the supplied Retry-After instead of retrying in a tight loop or rotating addresses. Keep request bodies small, because an oversized body is rejected before any price is worked out. The budget is roomier than it sounds: quoting a Valorant coaching hour and then a five-game teammate total at 20% off costs two calls, so a long conversation has plenty of headroom.
Limits are 60 requests per minute and 2,000 per day per IP. On HTTP 429, respect the response’s retry guidance and back off. Do not retry in a tight loop or rotate addresses to bypass the limit. Each accepted POST counts, including discovery and initialization. Request bodies are limited to 16,384 bytes; the complete tool response is capped at 65,536 bytes. HTTP 429 includes Retry-After and error.data.retryAfterSeconds. HTTP 503 means required server configuration is unavailable.
Which origins may call the Duoly endpoint?
Any well-formed HTTPS origin may call the Duoly endpoint. Native and server clients may omit Origin. A missing Origin is distinct from an empty, malformed or opaque value; invalid origins and plain HTTP origins are rejected before a tool runs. Cookies and browser credentials are not accepted, so a public catalog request can never borrow somebody's signed-in Duoly session.
An integration using Claude can therefore connect directly over HTTPS, with no proxy in front of the endpoint. Origin validation does not authorize account access or unlock order history. Only get_order_status accepts the separate private code for one order. To attribute a booking link, use the optional client query hint: claude, chatgpt or gemini. The hint changes the agent tag on generated links, never identity, pricing or permissions. Test both a valid HTTPS request and a rejected HTTP origin before releasing a browser client.
What data should a Duoly client send?
Catalog requests need structured choices, never personal details. Send the game, service, rank, region and quantity required by a tool. Names, emails, chat history, passwords, card details and account tokens have no place in a catalog request. A private order-status code is the sole exception: get_order_status accepts a customer-generated dos_ code to read one limited order projection.
That code is the one piece of sensitive input here: handing it to Claude or any other client reveals acceptance, teammate display names and the next step on a real order. Never log or persist it, put it into a booking URL or send it to an unrelated tool. Codes expire after seven days and can be revoked from the order room. Catalog tools cannot charge, reserve or cancel. Abuse prevention uses an IP-derived identifier; hosting infrastructure also processes connection metadata. Link users to Duoly to complete their booking, and keep the privacy policy and terms accessible.
Building a Duoly integration?
A Duoly integration is a read-only MCP client that ends on duoly.gg. Contact the team for partner questions and compatibility checks before shipping to users.
Most integrations go wrong in the same three places. A quote is never a reservation, because a teammate takes each order out of the Duoly queue and nobody is assigned one. Surface bookUrl as the primary link, so the person sees the final price before paying on duoly.gg. Send catalog tokens only, never names, emails or payment details. The figures themselves are simple: coaching is flat with no bundle discount, and teammate bookings take 10%, 20% and 25% off at three, five and ten units. On HTTP 429, wait out the supplied Retry-After instead of retrying in a tight loop.