# Connect to the Loadbay MCP

Loadbay is a catalog of **harnesses for AI agents** — and it's an MCP server too,
so your agent can browse the catalog directly instead of you copy-pasting links.

- **Endpoint:** `https://loadbay.xyz/api/mcp`
- **Transport:** Streamable HTTP (stateless)
- **Auth:** none — public (browse is read-only; `submit_harness` writes a community listing)

## Add it

**Claude Code**

```bash
claude mcp add --transport http loadbay https://loadbay.xyz/api/mcp
```

**Claude Desktop / Cursor / any `mcp.json`**

```json
{
  "mcpServers": {
    "loadbay": {
      "type": "http",
      "url": "https://loadbay.xyz/api/mcp"
    }
  }
}
```

(Cursor uses the same block in `~/.cursor/mcp.json`; some clients omit `"type"`.)

## Tools

| Tool | What it does |
| --- | --- |
| `list_domains` | The catalog's domains (trading, coding, browser, data, social, health, science, gaming, media, robotics, productivity). |
| `search_harnesses` | Search by free-text `query`, `domain`, and/or capability `trait` (`mcp` \| `oss` \| `keys` \| `sandbox` \| `guard`). |
| `get_harness` | Full details for one harness by `slug`. |
| `submit_harness` | **List your own harness.** Requires a public, open-source GitHub `repo`. Pass a `baseUsdcAddress` (0x…) if you want to collect tips. Appears immediately, tagged *community*. |
| `tip_harness` | **Tip an author in USDC over x402.** Pass `slug` and optional `amount` (USD). Returns the payable endpoint + payment details; GET it with your x402 wallet to send the tip (your wallet pays — Loadbay never holds funds). |

Each result includes the repo link and a shareable `https://loadbay.xyz/h/<slug>` URL.

### List your harness from your agent

> "Submit my harness to Loadbay: name `my-coinbase-harness`, repo
> `https://github.com/me/my-coinbase-harness`, domain `trading`, and pay tips to
> my Base USDC address `0x…`."

`submit_harness` arguments: `name`, `repo` (open-source GitHub, required),
`domain`, `summary`, plus optional `author`, `integrations[]`, `traits[]`,
`language`, and `baseUsdcAddress` (Base USDC wallet for tips — only if you want
to get paid). The repo's open-source license is verified on submit.

## Try it

> "Search Loadbay for open-source browser harnesses."
> "What MCP servers does Loadbay list for trading?"
> "Get the details for `browser-use` from Loadbay."

## Prefer plain HTTP?

The same catalog is a REST endpoint: `GET https://loadbay.xyz/api/harnesses`
(filter with `?domain=` / `?integration=`). See also [`/llms.txt`](/llms.txt).
