MCP — server & OAuth
MCP is the Wast'O MCP server (https://mcp.wast-o.com). It exposes data to agents (Cursor, SI automations), authenticated with OAuth2 (client_credentials or DCR / PKCE).
- The public
/publicAPI stays anonymous and citizen read-only. - MCP = machine credentials bound to one
cityGroupId, scopes, audit, optional bounded writes, MCP tools. - The Assistant = citizen chat (ASSIST'O), not the MCP.
Endpoints
| URL | |
|---|---|
| MCP (Streamable HTTP) | https://mcp.wast-o.com/mcp |
| Health | https://mcp.wast-o.com/health |
| Protected Resource Metadata | https://mcp.wast-o.com/.well-known/oauth-protected-resource |
| AS Metadata | https://api.wast-o.com/.well-known/oauth-authorization-server |
| Authorize | https://api.wast-o.com/oauth/authorize |
| Token OAuth | https://api.wast-o.com/oauth/token |
| DCR | POST https://api.wast-o.com/oauth/register |
| Consent UI | https://console.wast-o.com/oauth/connecto/authorize |
| Who am I | GET https://api.wast-o.com/oauth/me |
Auth modes
A. Interactive agent (Cursor) — DCR + PKCE
Cursor discovers OAuth (PRM → AS → DCR), opens the MCP consent page (pick CityGroup), then sends the Bearer on /mcp.
B. Machine / SI — client_credentials
- Console → Settings → MCP.
- Enable the module if needed.
- New client → copy
client_id/client_secret(once). - Scopes:
wasto.mcp.read(default), optionalwasto.mcp.write.
curl -s -X POST https://api.wast-o.com/oauth/token \
-H 'Content-Type: application/json' \
-d '{
"grant_type": "client_credentials",
"client_id": "wasto_cc_…",
"client_secret": "…"
}'
Do not reuse a console user JWT for agents.
Cursor / MCP config
{
"mcpServers": {
"wasto-connect": {
"type": "http",
"url": "https://mcp.wast-o.com/mcp"
}
}
}
MCP tools (current)
Server name: wasto-connect.
Context: wasto_whoami, wasto_get_context, wasto_list_city_groups, wasto_set_active_city_group, wasto_set_active_city, cities_list, cities_get
Read: waste_types_list, collection_places_list, recycling_points_list, challenges_list, challenge_get, surveys_*, field_reports_summary, media_* (city-group library only)
Write (wasto.mcp.write): waste_type_upsert, waste_type_detail_upsert, recycling_point_upsert, challenge_upsert — dryRun default, confirm=true to commit, no delete.
Full FR reference (tables + /oauth/mcp/* paths): keep the French MCP page as source of truth for the complete endpoint matrix.
See also
- Public API introduction
- MCP — user guide
- The Assistant — citizen chat (not MCP)