Understanding the Settld MCP Payments Skill for OpenClaw

What Is the Settld MCP Payments Skill?

The Settld MCP Payments skill is an OpenClaw skill that teaches AI agents how
to interact with paid MCP (Model Context Protocol) tools through the Settld
platform. This skill enables agents to discover, authorize, and execute paid
tool calls while maintaining proper payment flows and generating verifiable
receipts.

Core Functionality

The skill provides several key capabilities:

• Tool Discovery : Agents can discover available Settld MCP tools using the settld.* namespace
• Payment Authorization : Implements the x402 challenge/authorize/retry flow for paid tool calls
• Receipt Generation : Returns verifiable payment and settlement headers from tool responses
• Audit Trail : Produces audit-grade artifacts and receipts in Settld

Prerequisites for Implementation

To use this skill effectively, you'll need:

• Node.js 20+ runtime environment
• Settld API key (stored as 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)

Setting Up the MCP Server

The skill includes a server definition in mcp-server.example.json. To
register the server:

command: npx
args: ["-y","settld-mcp"]

Required environment variables:

• SETTLD_BASE_URL
• SETTLD_TENANT_ID
• SETTLD_API_KEY

Available Tool Categories

The skill provides access to several tool categories:

Paid Search and Data Tools

• settld.exa_search_paid - Paid search functionality
• settld.weather_current_paid - Current weather data with payment

Agreement Lifecycle Tools

• settld.create_agreement - Create new agreements
• settld.submit_evidence - Submit evidence for agreements
• settld.settle_run - Execute settlement processes
• settld.resolve_settlement - Resolve settlement outcomes

Testing and Verification

To verify the skill is working correctly, agents can use these 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"

Security Considerations

When implementing this skill, keep these security practices in mind:

• Always treat SETTLD_API_KEY as secret input
• Never print full API keys in chat output
• Keep paid tools scoped to trusted providers and tenant policy

Benefits for AI Agents

This skill provides several advantages for AI agents:

• Monetization : Enables agents to access premium tools and services
• Transparency : Provides verifiable payment trails and receipts
• Compliance : Ensures proper authorization flows for paid services
• Scalability : Supports complex workflows with multiple paid tools

Real-World Use Cases

Practical applications include:

• Research agents that need paid access to premium databases
• Financial analysis tools requiring market data subscriptions
• Weather-dependent applications needing accurate forecasts
• Legal or compliance tools requiring specialized data access

Integration with Existing Workflows

The Settld MCP Payments skill integrates seamlessly with existing OpenClaw
workflows. Agents can use standard MCP patterns while the skill handles the
payment infrastructure transparently.

Future Development

The skill represents a growing trend toward monetized AI tool ecosystems,
where agents can access premium services while maintaining proper payment
flows and audit trails.

Getting Started

To begin using this skill:

1. Set up your Settld account and obtain API credentials
2. Configure the required environment variables
3. Register the MCP server using the provided example
4. Test connectivity with settld.about
5. Begin exploring available paid tools

Conclusion

The Settld MCP Payments skill bridges the gap between AI agents and paid MCP
tools, providing a secure, transparent, and auditable payment infrastructure.
By implementing proper authorization flows and generating verifiable receipts,
it enables sophisticated AI workflows while maintaining financial
accountability.

Skill can be found at:
payments/SKILL.md>