| name | settld-mcp-payments |
| description | Connect OpenClaw agents to Settld MCP for paid tool calls with quote-bound authorization and verifiable receipts. |
| version | 0.1.0 |
| author | Settld |
Settld MCP Payments Skill
This skill teaches OpenClaw agents to use Settld for paid MCP tool calls.
What This Skill Enables
- Discover Settld MCP tools (
settld.*)
- Run paid tool calls with x402 challenge/authorize/retry flow
- Return verifiable payment/settlement headers from tool responses
- Produce audit-grade artifacts and receipts in Settld
Prerequisites
- Node.js 20+
- Settld API key (
SETTLD_API_KEY)
- Settld API base URL (
SETTLD_BASE_URL)
- Tenant id (
SETTLD_TENANT_ID)
- Optional paid tools base URL (
SETTLD_PAID_TOOLS_BASE_URL)
MCP Server Registration
Use the server definition in mcp-server.example.json.
Server command:
- command:
npx
- args:
["-y","settld-mcp"]
Required env vars:
SETTLD_BASE_URL
SETTLD_TENANT_ID
SETTLD_API_KEY
Optional env vars:
SETTLD_PAID_TOOLS_BASE_URL
SETTLD_PROTOCOL
Agent Usage Pattern
- Call
settld.about to verify connectivity.
- For paid search/data calls, use:
settld.exa_search_paid
settld.weather_current_paid
- For agreement lifecycle demo calls, use:
settld.create_agreement
settld.submit_evidence
settld.settle_run
settld.resolve_settlement
Smoke Prompts
- "Call
settld.about and return the result JSON."
- "Run
settld.weather_current_paid for Chicago in fahrenheit and include the x-settld-* headers."
Safety Notes
- Treat
SETTLD_API_KEY as secret input.
- Do not print full API keys in chat output.
- Keep paid tools scoped to trusted providers and tenant policy.