# Top5StocksAPI

> Top5StocksAPI is an MCP server for finance and payments. MCP server exposing daily AI-ranked stock, crypto and macro research to AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API
- **Repository:** https://github.com/top5stocksapi/mcp-server
- **MCP Registry name:** io.github.Top5StocksAPI/mcp-server
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [stock market data](https://ai-powered.com/categories/stock-market-data)
- **Listing updated:** 2026-11-21

## About

The README says this server wraps the Top 5 Stocks API so MCP-compatible clients such as Claude, Claude Code and Cursor can call its endpoints as tools. Each tool maps one-to-one to an API endpoint, and responses come back as raw JSON from the live API rather than summarised text.

Some tools need an API key set in the TOP5STOCKS_API_KEY environment variable, which the registry marks as a secret. The free tools, including the daily and crypto watchlists, cumulative performance endpoints and API metadata, run without a key. Paid tiers are labelled starter, pro and ultra.

The server suits developers and analysts who want an AI assistant to pull watchlist rankings or market data into their workflow. The README describes its content as educational market research and not financial advice.

## Features

- **One-to-one API tools:** Each MCP tool corresponds directly to an endpoint of the Top 5 Stocks API.
- **Free tools without a key:** Watchlist, cumulative performance and metadata tools work with no API key.
- **Tier-gated endpoints:** Starter, pro and ultra tools require a key set via environment variable.
- **Raw JSON responses:** Tool results are returned as unmodified JSON text from the live API.
- **Stdio transport:** Runs locally over stdio and can be launched with node or npx.

## Good for

- Asking an AI assistant for the daily AI-ranked stock watchlist
- Pulling crypto watchlist data into an agent workflow
- Reviewing cumulative performance figures from within Claude or Cursor
- Building research scripts that consume the Top 5 Stocks API through MCP

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server --env TOP5STOCKS_API_KEY='<TOP5STOCKS_API_KEY>' -- npx -y top5stocks-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "top5stocks-mcp-server"
      ],
      "env": {
        "TOP5STOCKS_API_KEY": "<TOP5STOCKS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "top5stocks-mcp-server"
      ],
      "env": {
        "TOP5STOCKS_API_KEY": "<TOP5STOCKS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "top5stocks-mcp-server"
      ],
      "env": {
        "TOP5STOCKS_API_KEY": "<TOP5STOCKS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "top5stocks-mcp-server"
      ],
      "env": {
        "TOP5STOCKS_API_KEY": "<TOP5STOCKS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "top5stocks-mcp-server"
      ],
      "env": {
        "TOP5STOCKS_API_KEY": "<TOP5STOCKS_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Do I need an API key to use Top5StocksAPI?

No. The README says free tools such as the daily and crypto watchlists, cumulative-performance endpoints and get_api_metadata work without a key. Starter, pro and ultra tools require one.

### How do I install Top5StocksAPI?

The README shows running npm install in a cloned repository and pointing the MCP client config at index.js. It also says the package can be run via npx top5stocks-mcp-server once published.

### Which clients does Top5StocksAPI work with?

The README names Claude Desktop, Claude Code, Cursor and other MCP-compatible agents.

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

Run this command in your terminal: claude mcp add mcp-server --env TOP5STOCKS_API_KEY='<TOP5STOCKS_API_KEY>' -- npx -y top5stocks-mcp-server

### What are the best alternatives to Top5StocksAPI?

The closest alternatives to Top5StocksAPI are Finance MCP, Finance: Stock, ETF & Crypto Data, TGMCharts, Alpha Vantage MCP and hanjialeGit.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Finance MCP](https://ai-powered.com/mcp/finance-mcp-3): Finance MCP is an open-source MCP server for finance and payments.
- [Finance: Stock, ETF & Crypto Data](https://ai-powered.com/mcp/finance-stock-etf-and-crypto-data): Finance: Stock, ETF & Crypto Data is a paid MCP server for finance and payments.
- [TGMCharts](https://ai-powered.com/mcp/tgmcharts): TGMCharts is a freemium MCP server for finance and payments.
- [Alpha Vantage MCP](https://ai-powered.com/mcp/alpha-vantage-mcp): Alpha Vantage MCP is a freemium MCP server for finance and payments.
- [hanjialeGit](https://ai-powered.com/mcp/hanjialegit): hanjialeGit is an open-source MCP server for financial data.
- [Crypto Prices Mcp](https://ai-powered.com/mcp/crypto-prices-mcp): Crypto Prices Mcp is a freemium MCP server for finance and payments.
- [axionquant](https://ai-powered.com/mcp/axionquant-2): axionquant is a freemium MCP server for finance and payments.
- [FinanceQuery](https://ai-powered.com/mcp/financequery): FinanceQuery is an open-source MCP server for finance and payments.

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