Settld MCP Payments

# 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

1. Call `settld.about` to verify connectivity.
2. For paid search/data calls, use:
3. - `settld.exa_search_paid`
4. - `settld.weather_current_paid`
5. For agreement lifecycle demo calls, use:
6. - `settld.create_agreement`
7. - `settld.submit_evidence`
8. - `settld.settle_run`
9. - `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.