MCP Server Documentation

General

Laguna's MCP server supports Streamable HTTP transport. No API keys or OAuth required — just connect and start earning.

https://agents.laguna.network/mcp

Claude Desktop

From Claude Desktop, go to Settings > Connectors and add a new custom connector with the following URL:

https://agents.laguna.network/mcp

Claude Code

Run the following command in your terminal:

claude mcp add --transport http laguna https://agents.laguna.network/mcp

Codex

Run the following command in your terminal:

codex mcp add laguna --url https://agents.laguna.network/mcp

Cursor

Open Cursor Settings > MCP > Add Server, or add the following to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "laguna": {
      "url": "https://agents.laguna.network/mcp"
    }
  }
}

VS Code

Ctrl/Cmd + P and search for MCP: Add Server. Select Command (stdio) and enter the following command:

npx mcp-remote https://agents.laguna.network/mcp

{
  "mcpServers": {
    "laguna": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://agents.laguna.network/mcp"]
    }
  }
}

Windsurf

Ctrl/Cmd + , to open Windsurf settings. Scroll to Cascade > MCP servers, select Add Server > Add custom server, and add the following:

{
  "mcpServers": {
    "laguna": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://agents.laguna.network/mcp"]
    }
  }
}

Zed

Cmd + , to open Zed settings and add the following:

{
  "context_servers": {
    "laguna": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://agents.laguna.network/mcp"],
      "env": {}
    }
  }
}

OpenClaw

Install the Laguna skills from our OpenClaw skills repo. OpenClaw handles the MCP connection automatically:

openclaw skills install github:Laguna-Team/Laguna-OpenClaw-Skills

Others

Hundreds of other tools now support MCP servers. Configure them with these settings: Command: npx, Arguments: -y mcp-remote https://agents.laguna.network/mcp, Environment: None

npx -y mcp-remote https://agents.laguna.network/mcp

Search or browse affiliate merchants. All parameters are optional — call with no params to see top cashback deals. Provide a query for fuzzy name search, or a category to browse by category.

{
  "merchants": [
    {
      "id": "trip-com",
      "name": "Trip.com",
      "category": "travel",
      "top_cashback": "4.95%"
    }
  ],
  "total": 1
}

Browse available merchant categories on Laguna. Returns categories with merchant counts, top cashback rates, and example merchants.

{
  "categories": [
    {
      "slug": "travel",
      "name": "Travel",
      "merchant_count": 12,
      "top_cashback_rate": "4.95%",
      "example_merchants": ["Trip.com", "Agoda", "Airalo"]
    }
  ]
}

Get detailed information about a specific merchant including cashback rates, cookie duration, and payout timeline.

{
  "merchant": {
    "id": "trip-com",
    "name": "Trip.com",
    "category": "travel",
    "description": "Global travel platform for flights, hotels, and activities",
    "cashback_rates": [
      { "sub_category": "Hotel", "rate": "4.95%" },
      { "sub_category": "Flight", "rate": "1.5%" }
    ],
    "cookie_days": 30,
    "payout_days": 60
  }
}

Create an affiliate tracking link for a merchant. Auto-provisions your agent account on first use. Returns a shortlink that earns USDC commission when users purchase through it.

{
  "link": {
    "shortcode": "abc123",
    "url": "https://l.laguna.network/r/abc123",
    "merchant": "trip-com",
    "created_at": "2026-03-27T10: 00: 00Z"
  },
  "agent": {
    "status": "active",
    "wallet_address": "0x1234...abcd"
  }
}

Get your agent dashboard with balance, performance summary, and optionally your links, conversions, and analytics. Call with no include for a quick balance check; add include sections for detailed data.

{
  "balance": {
    "pending_usdc": "12.50",
    "available_usdc": "45.00",
    "total_earned_usdc": "57.50"
  },
  "summary": {
    "total_links": 15,
    "total_clicks": 342,
    "total_conversions": 8
  }
}

Request USDC withdrawal to your wallet. Currently supports Base chain (EVM wallets). TON and Solana wallet support coming soon. A 1% fee applies. Withdraws full available balance by default.

{
  "withdrawal": {
    "id": "wd_abc123",
    "amount_usdc": "45.00",
    "fee_usdc": "0.45",
    "net_usdc": "44.55",
    "wallet_address": "0x1234...abcd",
    "status": "processing"
  }
}

Check the status of a withdrawal by its ID. Returns the current status, transaction hash (if completed), and BaseScan URL. Transfer typically completes within 5-15 seconds.

{
  "withdrawal": {
    "id": "wd_abc123",
    "status": "completed",
    "amount_usdc": "44.55",
    "tx_hash": "0xabc...def",
    "basescan_url": "https://basescan.org/tx/0xabc...def",
    "completed_at": "2026-03-27T10: 00: 15Z"
  }
}

Influencer / Creator

Turn every content piece into a monetization opportunity. Your agent auto-embeds tracked affiliate links in social posts, blog articles, and roundups.

You are a social media content assistant that helps users create engaging posts. You also have access to Laguna's affiliate network to monetize product mentions in posts.

When the user asks you to write or draft a post:
1. Identify all brands/products mentioned in the content
2. For each brand, check: search_merchants({ query: "brand" })
3. For each match, create a link: mint_link({ merchant_id, wallet_address: "{{WALLET}}", target_url? })
4. Embed shortlinks naturally in the post content
5. Add affiliate disclosure (platform-appropriate)

Content quality comes FIRST — never degrade a post just to fit an affiliate link. For roundup/listicle posts: batch-create links for all partnered brands, skip non-partnered ones gracefully.

ALWAYS use mint_link to generate your tracked link before sharing. Never share a raw merchant URL — only Laguna shortlinks.

Check your earnings anytime with get_dashboard and withdraw USDC to your wallet with withdraw.

Personal Shopper

Your always-on shopping companion. Silently checks for cashback on every brand mentioned in conversation and nudges before you buy.

You are a helpful AI assistant with an always-on commerce awareness layer. You have access to Laguna's affiliate cashback network. Your primary job is to help the user with whatever they need. Your secondary job is to NEVER let the user miss a cashback opportunity.

Whenever ANY brand, store, or product is mentioned in conversation — by the user OR by you — immediately check if it's on Laguna via search_merchants. If it is, get the rate with get_merchant_info and show the effective price after cashback.

Ask for the user's wallet address and country once at the start.

Always use mint_link with the user's wallet and geo to generate their tracked link. Make sure the purchase is done via this link.

Never mention cashback for merchants not on Laguna. Always answer the user's actual question first, cashback mention second.

Always remind user to buy via the mint_link to earn the cashback. Cashback pays for your compute or their next purchase.