Skip to content

AlphaTest mode: test dollars and BNB Testnet — no real money. About the alpha

SaTT

How-to guides

How to use the SaTT MCP server with an AI assistant

Connect Claude or any MCP client to https://satt.com/api/mcp to query AdPools, Quests, creators, oracles and receipts. Read-only, no key needed.

Last updated 2 min readPublished by SaTTDevelopersFrançais

In short

SaTT runs a public, read-only MCP server at https://satt.com/api/mcp. Add it to any MCP client as an HTTP server and your assistant can list AdPools, read Quests, search creators, verify payouts and search the docs. No account or API key is needed, and it can never post or spend anything.

On this page

What can an assistant do with the SaTT MCP server?

Every tool is a view over SaTT’s public API. Main tools:

  • list_adpools, get_adpool, list_fiat_pools, get_fiat_pool: pools, prices per network and stats.
  • list_quests, get_quest, verify_quest_draw: Quests and a recomputation of the verifiable draw.
  • search_creators, get_creator, get_directory_stats: the creator directory, Verified creators first.
  • get_oracle_network, list_oracles, list_oracle_jobs, get_capabilities: the oracle network and what each network can measure.
  • list_receipts, verify_receipt, list_attestations, verify_attestation: Oracle-signed payouts.
  • get_satt_price, get_satt_token, get_platform_info, search_docs.

Three prompts are included: evaluate_adpool, verify_payout and find_creators.

How do you connect a client, step by step?

  1. 1. Open your client’s MCP settings

    In Claude, an IDE or any MCP-compatible client, open the place where servers are configured.

  2. 2. Add the SaTT server

    Add an HTTP server named satt with the URL https://satt.com/api/mcp, for example: { "mcpServers": { "satt": { "type": "http", "url": "https://satt.com/api/mcp" } } }.

  3. 3. Check the tool list

    Restart or refresh the client; the SaTT tools should appear. From a terminal you can also send a JSON-RPC tools/list request to the same URL with curl.

  4. 4. Ask a question

    For example: “List active AdPools that pay on TikTok” or “Verify the draw of Quest 12”. Each answer includes the matching satt.com page in url.

What are the limits and formats?

  • Transport: streamable HTTP in stateless JSON mode (no session, no SSE).
  • Rate limit: 60 requests burst, then 1 per second per IP, plus the limits of the underlying API routes.
  • Crypto amounts are token base units (18 decimals); dollar amounts are integer cents.
  • Errors are returned as data, for example not_found or rate_limited with retryAfter.

Does the MCP server expose personal data?

No. No cookies are forwarded, so a tool can never see a session, and creator e-mail addresses never leave SaTT’s servers. The server is also listed in https://satt.com/llms.txt and the OpenAPI file. To check payouts by hand instead, see Verifiable payouts.

Key takeaways

  • Endpoint: https://satt.com/api/mcp, HTTP, no key.
  • Read-only: it cannot join, submit, claim or spend.
  • Covers pools, Quests, creators, oracles, receipts and docs.
  • Limit: 60-request burst, then 1 request per second per IP.
Explore the oracle network New to a term? See the glossary

Frequently asked questions

Do I need a SaTT account to use it?

No. The server only serves public data and requires no authentication.

Can my assistant create an AdPool through MCP?

No. There are no write tools. Creating, joining and claiming are done in the web app, where you sign them yourself.

Why does verify_quest_draw matter?

It recomputes the Merkle root, seed, winners and signer of a Quest draw independently, so an assistant can confirm a draw was fair. See the verifiable draw.

Official pages