English Français العربية

io.github.Top5StocksAPI/mcp-server

Official registry Search and web

Daily AI-ranked stock, crypto, and macro research data from the Top 5 Stocks API.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package top5stocks-mcp-server
Claude Code 
claude mcp add io-github-top5stocksapi-mcp-server -e 'TOP5STOCKS_API_KEY=<your top5stocks_api_key>' -- npx -y top5stocks-mcp-server@1.0.6
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-top5stocksapi-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "top5stocks-mcp-server@1.0.6"
            ],
            "env": {
                "TOP5STOCKS_API_KEY": "<your top5stocks_api_key>"
            }
        }
    }
}

Environment variables

  • TOP5STOCKS_API_KEY secret API key for starter/pro/ultra-tier tools. Free tools work without a key. Get a key at https://top5stocks.netlify.app/members.html

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Top 5 Stocks MCP Server

Exposes the Top 5 Stocks API as MCP tools for Claude, Claude Code, Cursor, and other MCP-compatible agents.

Setup

npm install

Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "top5stocks": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"],
      "env": {
        "TOP5STOCKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

TOP5STOCKS_API_KEY is only required for starter/pro/ultra-tier tools. Free tools (get_daily_watchlist_free, get_crypto_watchlist_free, cumulative-performance endpoints, get_api_metadata) work with no key.

Get a key at https://top5stocks.netlify.app/members.html

Or once published, run directly via npx (no local clone needed):

{
  "mcpServers": {
    "top5stocks": {
      "command": "npx",
      "args": ["-y", "top5stocks-mcp-server"],
      "env": {
        "TOP5STOCKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tools

Each tool maps 1:1 to an API endpoint (see index.js ENDPOINTS for the full list and plan requirements). All responses are raw JSON text from the live API.

Educational market research only — not financial advice.

Frequently asked questions

What is io.github.Top5StocksAPI/mcp-server?

Daily AI-ranked stock, crypto, and macro research data from the Top 5 Stocks API.

How do I install io.github.Top5StocksAPI/mcp-server?

It runs on your machine. In Claude Code: claude mcp add io-github-top5stocksapi-mcp-server -e 'TOP5STOCKS_API_KEY=<your top5stocks_api_key>' -- npx -y top5stocks-mcp-server@1.0.6. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Top5StocksAPI/mcp-server need an API key?

Yes. It expects TOP5STOCKS_API_KEY, which you set in its configuration.

Is io.github.Top5StocksAPI/mcp-server open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.Top5StocksAPI/mcp-server?

It is published by Top5StocksAPI. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.