mcpField
T
Top5StocksAPI

Top5StocksAPI

Local
github.com/Top5StocksAPIFinance0Updated 16w ago
Repository

About Top5StocksAPI

Top5StocksAPI exposes the Top 5 Stocks API as market-research tools for MCP-compatible clients such as Claude and Cursor. It returns raw JSON from live API endpoints covering stocks, crypto, and macro research.

Key features

  1. 01Provide stock and crypto watchlists
  2. 02Access cumulative-performance endpoints
  3. 03Retrieve API metadata
  4. 04Map tools to API endpoints and return raw JSON

Use cases

  1. 01Check the daily stock watchlist
  2. 02Review the crypto watchlist
  3. 03Retrieve market research data from a client

MCP support

It maps Top 5 Stocks API endpoints to MCP tools for compatible clients. Some tools require TOP5STOCKS_API_KEY, while free tools do not.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "top5stocksapi": {
      "command": "npx",
      "args": [
        "-y",
        "top5stocks-mcp-server"
      ],
      "env": {
        "TOP5STOCKS_API_KEY": "<TOP5STOCKS_API_KEY>"
      }
    }
  }
}
Run commandnpx -y top5stocks-mcp-server
Environment variables to set
TOP5STOCKS_API_KEYSecretAPI key for starter/pro/ultra-tier tools. Free tools work without a key. Get a key at https://top5stocks.netlify.app/members.html

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmtop5stocks-mcp-server1.0.6

Tools

21

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.