Назад към всички

settld-mcp-payments

// Connect OpenClaw agents to Settld MCP for paid tool calls with quote-bound authorization and verifiable receipts.

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namesettld-mcp-payments
descriptionConnect OpenClaw agents to Settld MCP for paid tool calls with quote-bound authorization and verifiable receipts.
version0.1.0
authorSettld

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:
    • settld.exa_search_paid
    • settld.weather_current_paid
  3. 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.