io.github.lonniev/tollbooth-oauth2-collector

repo:https://github.com/lonniev/tollbooth-oauth2-collector

Unauthenticated OAuth2 callback collector for Tollbooth MCP services

transport:: remote
credential class:: self-provisionable
repo:: https://github.com/lonniev/tollbooth-oauth2-collector

Owner verification

Not yet verified. Verifying proves you control this server and is free, permanently — it never changes a published score.

Start verification →

Tools

collector_status
Health check — shows the number of pending authorization codes and TTL.
shallow
retrieve_code
Retrieve a stored authorization code (one-time read, auto-deleted). Called by the originating MCP server to pick up the code after the user has authorized in the browser. Returns the encrypted code which the caller decrypts using the same state token. Args: state: The state token (patron npub) used during authorization. Returns: Dict with ``code`` (encrypted) on success, or ``error`` if not found.
shallow
service_status
Report the running build so a redeploy can be verified. Free. Delegates to the SDK's canonical ``build_service_status`` — the single source of the service_status payload shape — so this collector reports the same envelope as every other DPYC service. The load-bearing field is ``build_info.fastmcp_cloud_git_commit_sha``: the commit Horizon actually deployed. The post-merge deploy-verify probe reads it to confirm the live service redeployed the merged sha; with no ``service_status`` tool to probe, that sha reads as ``<none>`` and an otherwise-healthy deploy is flagged as "did not land". The vault/courier/operator fields are ``False``/empty by construction — this is an unauthenticated community utility with no operator runtime.
shallow
store_code
Store a sealed OAuth2 authorization code. Called by the serverless callback function after the browser redirect. The ``state`` carries BOTH the patron npub (the lookup/retrieve key) and the operator npub (the PUBLIC key the code is sealed to) — see the SDK's ``pack_oauth_state``. The code is sealed with NIP-44 to the operator so only that operator's nsec can open it; the Neon row is keyed by the patron npub, so retrieval (``retrieve_code(state=patron_npub)``) is unchanged. Args: code: The authorization code from the OAuth provider. state: The packed state (``patron_npub.operator_npub``). Returns: Dict with ``success`` key and a message.
shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/0e742383-e371-4859-aa9e-3685076a2d92/badge.svg)](https://vouch.tools/servers/0e742383-e371-4859-aa9e-3685076a2d92)