gaents
gaents 에이전트 마켓플레이스를 위한 원격 MCP 서버(streamable HTTP): 'catalogue' 도구는 가격과 정보를 포함한 모든 모듈을 나열하고, 'chat' 도구는 OpenAI 스타일 모델 라우트를 호출합니다(gaents API 키 필요).
호스팅형 MCP 서버
npx add-mcp 'https://api.gaents.com/mcp'Claude Code, Codex, Cursor 등에 설치됩니다
문서
Quickstart
Every listing works over plain HTTP. Model routes speak the OpenAI API. Payment is a 402 handshake: ask, get a signed quote, pay, retry with proof. Or sign up and pay from a balance.
Setting up an agent? Paste /agents/quickstart.md into its context: ordered checks, copy-paste commands and the fix for each error the API returns.
Read from the API when this page was built (2026-11-21T02:07:43Z): /pay402/health answered ok at 2026-11-21T02:07:26Z; payments open; rails offered: internal_balance, bsv_tx, x402_usdc. /v1/models listed 11 models at 2026-11-21T02:07:26Z.
1. Find something
curl -s https://gaents.com/catalogue.json | python3 -c 'import json,sys; [print(l["id"], l["kind"], l["title"]) for l in json.load(sys.stdin)["listings"]]'
Each listing has facts (value, source, retrieved_at, method), prices and call. Agents can start from /llms.txt or /.well-known/gaents.json.
2. Get a key
One click on the dashboard, or POST https://api.gaents.com/v1/accounts (see Start). The key is shown once.
3. Call a model (OpenAI SDK)
from openai import OpenAI
client = OpenAI(base_url="https://api.gaents.com/v1", api_key=GAENTS_KEY)
r = client.chat.completions.create(model="gaents/glm-flash", messages=[{"role": "user", "content": "..."}])
Model ids served at 2026-11-21T02:07:26Z: gaents/claude-haiku · gaents/claude-opus · gaents/claude-sonnet · gaents/deepseek · gaents/deepseek-flash · gaents/fable · gaents/glm-flash · gaents/gpt-oss · gaents/grok · gaents/qwen-27b · gaents/qwen-flash.
4. Pay per call without an account (HTTP 402)
curl -i -X POST https://api.gaents.com/v1/chat/completions -H 'Content-Type: application/json' -d '{...}'
# 402 Payment Required, body: accepts[] with a signed quote, price, quote_id, expiry
curl -X POST https://api.gaents.com/v1/chat/completions -H 'X-PAYMENT: <base64 proof>' -H 'Content-Type: application/json' -d '{...}'
Pay with one of the rails the API offers: internal_balance, bsv_tx, x402_usdc (as of 2026-11-21T02:07:26Z). Discovery: https://api.gaents.com/.well-known/x402 (answered 200 at 2026-11-21T02:07:26Z).
5. From an agent (MCP)
https://api.gaents.com/mcp answered 200 at 2026-11-21T02:07:26Z. Methods: initialize, tools/list, tools/call.
6. Check it
Public boards: /v1/reliability (11 listings when read at build, 2026-11-21T02:07:43Z) and /v1/capacity (answered 200 at 2026-11-21T02:07:26Z).
Every call becomes ledger rows and a signed proof. Prove it shows how to re-check any call and the ledger's head hash yourself. Service state: Status.
7. Failover and the family that served you
Everything in this section is what https://api.gaents.com/v1/chat/completions answered to our probes at 2026-11-21T02:07:39Z (raw: /docs/api-probes.json).
The request header
Header X-Gaents-Failover, values: same-family or any. Any other value is refused before any money moves: we sent gaents-docs-probe-not-a-mode without a key and got HTTP 400 bad_failover, “X-Gaents-Failover: one of ['same-family', 'any']”.
Default when you send no header: any (https://api.gaents.com/pay402/health#failover.default, setting models.failover_default); any (https://api.gaents.com/v1/models#failover.default, setting models.failover_default)
From a browser: the API's CORS preflight for origin https://gaents.com allows X-Gaents-Failover (HTTP 204).
curl -s -D - https://api.gaents.com/v1/chat/completions -H "Authorization: Bearer $GAENTS_KEY" \
-H 'X-Gaents-Failover: same-family' -H 'Content-Type: application/json' \
-d '{"model": "gaents/glm-flash", "messages": [{"role": "user", "content": "Reply with the word OK."}], "max_tokens": 64}'
The served family
Our call to gaents/glm-flash with X-Gaents-Failover: same-family answered HTTP 200 with response header X-Gaents-Served-Family: glm-flash and JSON field "served_family": "glm-flash". The browser can read the header: yes (Access-Control-Expose-Headers on that answer). Charged $0.000012; its proof: 2bf759457c94db90dd15336389adada3.
Streamed ("stream": true): HTTP 200, header X-Gaents-Served-Family: glm-flash; 8 of 8 data chunks carried served_family (glm-flash).
What same-family does when the alias's own family has no live route: NOT PROBED (the API publishes no per-family live-route count, so the build cannot pick an alias in that state to show it).
8. Pay only for verified output (result jobs)
Result jobs: the caller pays only when EVERY check passes on that call's output; otherwise no charge and our cost is booked as the route's loss. (pay402's job table result_jobs.json, sha256 2397be8fb0749516, read 2026-11-21T02:07:44Z; the table, not an API reading.)
GET /v1/jobs at 2026-11-21T02:07:44Z listed 0 result jobs ("result": true).
Result jobs that are not live (that GET /v1/jobs answer lists them with "live": false and a why):
site-facts-verified: A website's title, emails and phones, each checked on the live page (pay only if verified). Not live; the API's why: built and tested; not switched on for sale yet:POST https://api.gaents.com/v1/jobs/site-facts-verifiedwithout a key answered HTTP 404 job_off at 2026-11-21T02:07:44Z.
The verdict on a paid call's public proof: NOT PROBED (no result job is live to call).