# RealtimeAPI.ai

> RealtimeAPI.ai is a freemium MCP server for finance and payments. Pay-per-call or keyed market, news, macro and prediction data feeds for AI agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API, Web
- **Website:** https://realtimeapi.ai/docs
- **MCP Registry name:** ai.realtimeapi/mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

Every feed sits behind one gateway at api.realtimeapi.ai, and the same catalogue is reachable over MCP at mcp.realtimeapi.ai. The platform server exposes five tools: discover, list_feeds, get_quote, call_feed and create_free_key. Only call_feed needs a key or an x402 payment, so an agent can browse what exists and see a price before it spends anything.

Payment is the unusual part. An unpaid request returns HTTP 402 with the price, and an x402 client signs a USDC authorization on Base and retries. Settlement happens only after the provider returns a 2xx, so failed calls are not charged. Agents that run all day can buy a time pass (1 hour to 30 days) or a Builder or Scale plan instead of paying per request.

Feeds named in the docs cover crypto, stocks, macro data, news signals, prediction markets, weather alerts, grid and energy data and environmental sensors, each with an OpenAPI 3.1 document that lists a price per operation. Each feed also has its own paid MCP endpoint.

## Features

- **Five-tool platform server:** discover, list_feeds, get_quote, call_feed and create_free_key cover search, pricing and calls.
- **x402 pay per request:** Agents pay in USDC on Base per call with no account or key.
- **Free monthly key:** A free key gives 1,000 calls a month across every feed.
- **Time passes and plans:** Time passes from 1 hour to 30 days, plus Builder at $29 and Scale at $199 for 30 days.
- **Billing only on success:** Non-2xx provider answers pass through and are not charged or settled.
- **Cache control headers:** Send Cache-Control max-age to skip older cached copies at the same price.

## Good for

- Give a trading agent live crypto and stock quotes
- Pull macro and news signals into a research agent
- Let an autonomous agent pay for data without signing up
- Check a feed's price before calling it
- Track weather alerts or grid data from an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.realtimeapi.ai/mcp
```

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

```sh
https://mcp.realtimeapi.ai/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.realtimeapi.ai/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.realtimeapi.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.realtimeapi.ai/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.realtimeapi.ai/mcp"
    }
  }
}
```

## Tools

- `discover`: Search the feed catalogue, optionally with a maximum price.
- `list_feeds`: List available data feeds.
- `get_quote`: Get the price of a feed call before making it.
- `call_feed`: Call a feed; needs a key or an x402 payment.
- `create_free_key`: Create a free key with 1,000 calls a month.

## FAQ

### Do I need an account to call a feed?

No. Agents can pay each request in USDC with x402, or use a free or paid key.

### What does the free key include?

1,000 calls a month across every feed.

### Am I charged for failed requests?

No. Only 2xx responses are billed; provider errors and quota 429s are not charged.

### Which MCP tool needs payment?

Only call_feed needs a key or an x402 payment.

### Is RealtimeAPI.ai free?

RealtimeAPI.ai has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

### How do I add RealtimeAPI.ai to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.realtimeapi.ai/mcp

### What are the best alternatives to RealtimeAPI.ai?

The closest alternatives to RealtimeAPI.ai 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/realtimeapi-ai
