SkillHub

settld-mcp-payments

v0.1.0

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

Sourced from ClawHub, Authored by aidenlippert

Installation

Please help me install the skill `settld-mcp-payments` from SkillHub official store. npx skills add aidenlippert/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.