# TradeAlmanac

> TradeAlmanac is a freemium MCP server for finance and payments. Russian-market dividends, screener, sentiment and seasonality data for AI agents. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, CLI
- **Website:** https://tradealmanac.com/en/developers/mcp
- **MCP Registry name:** com.tradealmanac/mcp-server
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-17

## About

This is a thin wrapper over TradeAlmanac's public data interface, adding no data or load of its own, and it works with a personal reader key that is free to issue. Free keys allow 60 requests a minute and 1,000 a day, and when the quota runs out the server returns the wait time instead of retrying. A sandbox key lets you try it with a daily snapshot that uses no quota.

The data centres on dividend history with announcement statuses (a forecast has to be called a forecast), a stock screener with sector codes, a record-date calendar paged by cursor, sentiment indicators for Russian and US markets and calendar effects such as how an index tends to behave in January, with observation counts and significance. Without a key only indicators, calendar effects and stock lists answer.

It deliberately has no share-price tool: MOEX quotes, candles and the instrument reference, and global market data, are outside the contract for licensing reasons, and the server tells the model to say so rather than invent numbers. Optional personal tools for watchlists, alerts and a virtual paper portfolio need separate permissions and never touch a real broker.

## Features

- **Dividend history:** Compares payouts over time with announcement statuses such as forecast.
- **Stock screener:** Filters by yield, P/E and sector codes and returns tables.
- **Record-date calendar:** Lists upcoming dates, paged by cursor, suitable for CSV export.
- **Sentiment and seasonality:** Reads indicators and calendar effects with observation counts and significance.
- **Honest limits:** Notes truncated answers and refuses to supply prices it is not licensed for.
- **Paper portfolio:** With separate permission, lets an agent place virtual practice orders only.

## Good for

- Screen oil and gas stocks by dividend yield and P/E
- Compare the dividend history of two Russian companies
- Export upcoming record dates to CSV
- Ask about market mood and how an index behaves in a given month

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-server https://tradealmanac.com/mcp
```

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

```sh
https://tradealmanac.com/mcp
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://tradealmanac.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://tradealmanac.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://tradealmanac.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://tradealmanac.com/mcp"
    }
  }
}
```

## FAQ

### Do I need a key?

Only for some tools; indicators, calendar effects and stock lists answer without one, and keys are issued free in the account.

### Can it give live prices?

No. Quotes, candles and the instrument reference are not part of it for licensing reasons.

### What are the limits?

A free key allows 60 requests a minute and 1,000 a day.

### Can the agent place real trades?

No. The optional paper portfolio uses virtual money and sends nothing to a broker or exchange.

### Is TradeAlmanac free?

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

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

Run this command in your terminal: claude mcp add --transport http mcp-server https://tradealmanac.com/mcp

### What are the best alternatives to TradeAlmanac?

The closest alternatives to TradeAlmanac 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/tradealmanac
