# Roundhouse

> Roundhouse is a freemium MCP server for analytics and data. Read-only analytics on x402 agent payments and ERC-8004 agent identity, with SQL. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://roundhouseai.io/docs/api/mcp
- **MCP Registry name:** io.roundhouseai/roundhouse
- **Categories:** analytics and data, finance and payments
- **Listing updated:** 2026-11-16

## About

Roundhouse indexes settlements of x402 agent payments and ERC-8004 agent identity records, and its MCP endpoint exposes the same read endpoints as tools, one per REST route. A tool call is forwarded to the matching endpoint and answered by that endpoint's own checks, so there is no separate MCP account, quota or key: the same API key, the same per-minute limit shared across an organisation's keys and the same Query Unit charge on SQL queries apply.

Five discovery tools (get_account, list_capabilities, get_capability, recommend_capability_offers and list_services) work with no credential, and get_account reports what a credential resolves to, remaining balance and what each route costs in Query Units and USDC. Keys go in an Authorization header, never in the URL, which the docs justify by the MCP authorization spec. Clients that cannot set headers, such as Claude's custom connector, can sign in through OAuth 2.1 with dynamic client registration, and the consent screen separates reading the index from running SQL, which spends units.

A trial key costs $0.01 paid over x402, lasts 30 days, has a low rate limit and does not cover run_sql. Paid plan prices are not given in the page text.

## Features

- **Settlement index:** Reads x402 payment flows and ERC-8004 identity data.
- **SQL access:** Runs SQL queries, metered at one Query Unit each on paid plans.
- **Free discovery tools:** Five tools work without any credential.
- **OAuth sign-in:** Supports OAuth 2.1 for clients that cannot send headers.
- **Separate permissions:** Reading and running SQL are granted independently.
- **Revocable connections:** Connected apps can be revoked from the dashboard.

## Good for

- Analyse x402 payment volumes between agents
- Look up ERC-8004 identity records
- Run ad hoc SQL over the settlement index
- Check what a call will cost before making it
- Review which apps are connected to your organisation

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http roundhouse https://api.roundhouseai.io/v0/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.roundhouseai.io/v0/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "roundhouse": {
      "url": "https://api.roundhouseai.io/v0/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "roundhouse": {
      "type": "http",
      "url": "https://api.roundhouseai.io/v0/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "roundhouse": {
      "serverUrl": "https://api.roundhouseai.io/v0/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "roundhouse": {
      "type": "http",
      "url": "https://api.roundhouseai.io/v0/mcp"
    }
  }
}
```

## Tools

- `get_account`: Reports what your credential resolves to, balance and route costs.
- `list_capabilities`: Lists available capabilities.
- `get_capability`: Reads one capability.
- `recommend_capability_offers`: Recommends capability offers.
- `list_services`: Lists services.
- `list_flows`: Lists payment flows, equivalent to GET /v0/flows.
- `run_sql`: Runs a SQL query against the index, metered in Query Units.

## FAQ

### Do I need a separate MCP key?

No. The same API key as the REST endpoints is used, with shared limits and billing.

### Which tools need no credential?

get_account, list_capabilities, get_capability, recommend_capability_offers and list_services.

### Can I try it cheaply?

A trial key costs $0.01 paid over x402, expires after 30 days and does not include run_sql.

### Why is the key not allowed in the URL?

The MCP authorization spec forbids access tokens in the query string, and URLs leak into logs and screenshots.

### Is Roundhouse free?

Roundhouse has a free plan, with paid plans for more usage or features.

### How do I add Roundhouse to Claude Code?

Run this command in your terminal: claude mcp add --transport http roundhouse https://api.roundhouseai.io/v0/mcp

### What are the best alternatives to Roundhouse?

The closest alternatives to Roundhouse are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/roundhouse
