Kobaru
  1. Effortless MCP
Kobaru
  • Kobaru.io Gateway API
    • Introduction
      • What is Kobaru?
      • Quick start
      • How x402 works
    • Integration
      • Standard x402 SDK
      • Advanced SDK
      • Transparent proxy integration
      • Direct API integration
    • Core Concepts
      • Available Chains and Assets
      • Payment schemes
      • Security
      • Usage models
    • Guides
      • Pricing your API
      • Going to Production
      • Testing with devnet
      • Bazaar discovery
      • BITE encryption for SKALE
    • API Reference
      • Error Handling
      • Get Supported Payment Kinds
      • Verify Payment Authorization
      • Settle Payment
    • Discovery
      • List Discovery Resources
    • Transparent Proxy
      • Overview - Transparent Proxy
      • Upstream authentication
      • Troubleshooting
      • Constraints and security
      • Capabilities and routes
      • Domain verification
      • Service setup
    • Effortless MCP
      • Kobaru MCP Overview
      • Wallets
      • CLI reference
      • Setup Template
    • Schemas
      • SupportedResponse
      • ErrorResponse
      • UnauthorizedResponse
      • RateLimitResponse
      • VerifySuccessResponse
      • VerifyErrorResponse
      • SettleSuccessResponse
      • SettleErrorResponse
      • DiscoveryResourceItem
      • ListDiscoveryResourcesResponse
  1. Effortless MCP

Setup Template

Connect to {Company Name} via MCP#

  TEMPLATE FOR MERCHANTS

  Replace these placeholders before sharing with your users:
    {Company Name}    → Your company name (e.g., "WeatherCo")
    {merchant-slug}   → Your Kobaru merchant slug (e.g., "weatherco")
    {service-slug}    → Your service slug (e.g., "weather-api")
    {description}     → Short description of what your API does
    {tool-examples}   → List your available tools and what they do
    {network}         → Payment network (e.g., "Base", "SKALE")
    {token}           → Payment token (e.g., "USDC", "WBTC")
    {pricing}         → Your pricing info (e.g., "$0.001 per request")

  You can also generate this guide — pre-filled with your merchant details, tools, and pricing — from the https://console.kobaru.io/mcp.
  
  Delete this comment block before publishing.
{Company Name} is available as an MCP (Model Context Protocol) server powered by Kobaru's Effortless MCP. This lets AI agents like Claude, GPT, and custom agents discover and use {Company Name} tools directly — with built-in micropayments and no API keys.
{description}
Why this works differently: Traditional MCP servers require API keys, OAuth flows, and billing integration. With Effortless MCP, your users' wallet is their credential — no API keys to manage, no subscriptions to set up. They fund a self-custody wallet and pay per use, with full budget controls. Learn more about Effortless MCP.

Quick start#

1. Run the setup wizard#

You need Node.js installed. The Kobaru MCP Client works on Linux, macOS, and Windows — open your terminal and run:
Already have Kobaru MCP installed? Just add this service:
The wizard configures your AI client, creates a wallet, and sets a spending budget — all in one flow. It supports 8 AI clients out of the box (Claude Code, Claude Desktop, Cursor, Windsurf, Codex, Gemini CLI, Antigravity, OpenCode) and provides manual setup instructions for other MCP-compatible tools.
After setup, restart your AI client. The tools appear automatically.

2. Fund your wallet#

This tool uses cryptocurrency for payments — this enables instant, global micropayments without credit cards or subscriptions. You don't need any prior crypto experience — the setup wizard handles everything.
The wizard lets you choose your wallet: create a local wallet (private key stored on your machine) or connect a Coinbase smart wallet via AWAL. Either way, it prints your wallet address so you can send a small amount of {token} to get started.
Typical usage costs {pricing}, so $1–5 worth of {token} lasts weeks. Kobaru and {Company Name} does not have access to your funds — you hold your balance in your own wallet, and payments are only made when a tool is called, subject to your approval and budget limits.
Supported networks:
SKALE on Base
Base

3. Start using tools#

Once connected, your AI agent can use {Company Name} tools. Try asking:
"Use {Company Name} to ..."

Available tools#

{tool-examples}

How payments work#

Self-custody — your funds stay in your wallet. {Company Name} never has access to your balance.
Pay-per-use — you only pay when a tool is called successfully
Budget controls — set per-request, daily, and lifetime spending limits
Approval required — your AI agent sees the cost before every call and respects your budget
Micropayments — costs are fractions of a cent per call
No API keys or subscriptions — your wallet replaces traditional credentials

Managing your budget#

Set spending limits to stay in control:
For the full list of commands, see the CLI reference.

Troubleshooting#

"No tools found"
Make sure you completed the setup wizard: kobaru-mcp setup {merchant-slug}
Restart your AI client after setup
Check the merchant slug is correct: {merchant-slug}
"Payment failed"
Check your wallet has enough {token} on the correct network
Try a different network if one is congested
"Connection refused"
Check your firewall or proxy settings
Make sure Node.js 18 or later is installed: node --version

Support#

{Company Name} support:
Kobaru CLI reference: CLI reference
Kobaru documentation: docs.kobaru.io
Modified at 2026-02-25 19:32:34
Previous
CLI reference
Next
SupportedResponse
Built with