Skip to content
MCP server

Top5StocksAPI

MCP server exposing daily AI-ranked stock, crypto and macro research to AI agents

Runs locally
Install

Top5StocksAPI is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Platforms
CLI, API
Runs
Locally
Version
1.0.6
Listing updated

Similar MCP servers

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

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

About Top5StocksAPI

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.

What it does

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

Top5StocksAPI 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.

How AIPoweredBot checks servers