Skip to main content

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

Versus the public API and the Assistant
  • The public /public API 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
Healthhttps://mcp.wast-o.com/health
Protected Resource Metadatahttps://mcp.wast-o.com/.well-known/oauth-protected-resource
AS Metadatahttps://api.wast-o.com/.well-known/oauth-authorization-server
Authorizehttps://api.wast-o.com/oauth/authorize
Token OAuthhttps://api.wast-o.com/oauth/token
DCRPOST https://api.wast-o.com/oauth/register
Consent UIhttps://console.wast-o.com/oauth/connecto/authorize
Who am IGET 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​

  1. Console → Settings → MCP.
  2. Enable the module if needed.
  3. New client → copy client_id / client_secret (once).
  4. Scopes: wasto.mcp.read (default), optional wasto.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​