Connect your agent
SatPortal is an MCP server. Add it to any MCP-capable agent:
claude mcp add --transport http satportal https://satportal.decredcommunity.org/mcp \ --header "Authorization: Bearer <your key>"
No key yet? Add it without the header — the free about and
register tools bootstrap an account autonomously, or pay per call with no account at all.
Three ways to pay
| Mode | How | Best for |
|---|---|---|
| Prepaid credits | register once, topup $5/$20/$100, send your bearer key | Regular use; cheapest friction |
| Per-call USDC | x402 AutoPayment on Base; sign the eip155 accepts entry | EVM-wallet agents, zero setup |
| Per-call Decred | Pay the bip122 entry's Lightning invoice; retry with the preimage | Decred stack agents (dcr402, dcrpulse) |
Pairing with dcrpulse
Running dcrpulse with its MCP agent tools? Connect your agent to both servers and it pays SatPortal in DCR by itself:
- Call a paid SatPortal tool — the result is a payment challenge with a Lightning entry.
- Pass that challenge to dcrpulse's
x402_pay_challenge(needs an agent spend grant with the x402 scope). - Retry the SatPortal call with the returned payload under
_meta["x402/payment"].
The receipt in _meta["x402/payment-response"] carries a reusable credential;
the first settled payment also returns a SatPortal API key for credit mode.
REST instead of MCP
Everything mirrors under https://satportal.decredcommunity.org/api/v1 — see the docs and
openapi.json.