# 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.

Published by SaTT · Last updated 2026-10-29 · How-to guides · https://satt.com/guides/how-to/use-mcp-server

## In short

SaTT runs a public, read-only [MCP](https://satt.com/guides/glossary#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.

## 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](https://satt.com/guides/glossary#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. **Open your client’s MCP settings** — In Claude, an IDE or any MCP-compatible client, open the place where servers are configured.
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. **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. **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`.

> **Warning:** The server is read-only by design: joining Quests, submitting posts and claiming stay in the web app, signed by the user.

## 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](https://satt.com/attestations).

## 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.

## 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](https://satt.com/guides/features/verifiable-draw).

## Related guides

- [SaTT MCP server and API for AI agents](https://satt.com/guides/features/mcp-api)
- [Verifiable payouts: attestations and receipts](https://satt.com/guides/features/verified-receipts)
- [Verifiable draw: how Quest winners are picked fairly](https://satt.com/guides/features/verifiable-draw)
- [The creator directory: find creators by network](https://satt.com/guides/features/creator-directory)

## Official pages

- [Oracle network](https://satt.com/oracles)
- [Verifiable payouts](https://satt.com/attestations)

Glossary: https://satt.com/guides/glossary