# SaTT MCP server and API for AI agents

> SaTT’s public, read-only MCP server at satt.com/api/mcp: tools for AdPools, Quests, creators, oracles, receipts and docs, rate limits and setup.

Published by SaTT · Last updated 2026-10-29 · Features · https://satt.com/guides/features/mcp-api

## In short

SaTT runs a public, read-only [MCP](https://satt.com/guides/glossary#mcp) server at `https://satt.com/api/mcp` that lets AI assistants query AdPools, dollar pools, Quests, the creator directory, the oracle network, receipts, attestations and the docs. It needs no authentication, exposes only public data and has no write tools.

## What is the SaTT MCP server?

It is a Model Context Protocol endpoint that wraps SaTT’s public REST API, so an assistant gets the same validated, privacy-filtered data as the website.

| Item | Value |
| --- | --- |
| Endpoint | `POST https://satt.com/api/mcp` |
| Transport | Streamable HTTP, stateless JSON mode (no session, no SSE) |
| Authentication | None: public data only |
| Rate limit | Per IP: 60 requests burst, then 1 request per second |

Every tool is read-only. Submitting posts, joining Quests and claiming stay in the web app, signed by the user.

## Which tools does it offer?

- `get_platform_info`: editions, alpha status, pool kinds, fees, token, Verified-creator rule.
- `get_satt_price`, `get_satt_token`: price and token supply, burn and liquidity.
- `list_adpools`, `get_adpool`, `list_fiat_pools`, `get_fiat_pool`: crypto and dollar pools with 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`, `get_oracle`, `list_oracle_jobs`, `get_oracle_job`, `match_ownership`, `list_oracle_providers`: the [oracle network](https://satt.com/guides/glossary#oracle-network).
- `get_capabilities`: what can be measured per network.
- `list_receipts`, `verify_receipt`, `list_attestations`, `verify_attestation`: [receipts](https://satt.com/guides/glossary#receipt) and [attestations](https://satt.com/guides/glossary#attestation).
- `search_docs`: search of the SaTT reference documentation.

It also exposes two resources (platform facts and the Markdown reference) and three prompts: `evaluate_adpool`, `verify_payout` and `find_creators`.

## How do you connect an assistant?

Add the server to your MCP client configuration:

`{ "mcpServers": { "satt": { "type": "http", "url": "https://satt.com/api/mcp" } } }`

Step-by-step setup and a curl test are in [Use the MCP server](https://satt.com/guides/how-to/use-mcp-server).

## How should you read the results?

- Every result includes `url`, the matching satt.com page, so answers can cite it.
- Crypto amounts are token base units (18 decimals); dollar amounts are integer cents.
- Errors are returned as data with `isError: true` and a code such as `not_found` or `rate_limited` (with `retryAfter`).
- Creator e-mails and sessions never leave the server: no cookie is forwarded to the API.

The server is also listed in `https://satt.com/llms.txt`, in `https://satt.com/openapi.json` and in the API catalog at `https://satt.com/.well-known/api-catalog`.

## Key takeaways

- Endpoint: POST https://satt.com/api/mcp, no authentication.
- Read-only: no tool can submit, join, claim or change anything.
- Tools cover pools, Quests, creators, oracles, receipts, capabilities and docs.
- Crypto amounts are 18-decimal base units; dollars are integer cents.
- Rate limit per IP: 60 burst, then 1 request per second.

## Frequently asked questions

### Do I need an API key?

No. The MCP server is public and serves only public data, with a per-IP rate limit.

### Can an AI agent apply to an AdPool through MCP?

No. All tools are read-only. Applying, joining a Quest or claiming requires the user’s own signature in the web app.

### Can the MCP server verify a Quest draw?

Yes. `verify_quest_draw` recomputes the Merkle root, seed, winners and signer, and returns the beacon block to check on an explorer.

## Related guides

- [How to use the SaTT MCP server with an AI assistant](https://satt.com/guides/how-to/use-mcp-server)
- [The oracle network: who measures SaTT posts](https://satt.com/guides/features/oracle-network)
- [Verifiable payouts: attestations and receipts](https://satt.com/guides/features/verified-receipts)
- [How to become an oracle and get paid to measure posts](https://satt.com/guides/how-to/become-an-oracle)

## Official pages

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

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