Top5StocksAPI

io.github.Top5StocksAPIPublished by GitHub account Top5StocksAPIv1.0.6Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

A local MCP server that exposes the Top 5 Stocks API so an assistant can pull daily AI-ranked stock, crypto and macro research data.

What you can do
Retrieve daily AI-ranked stock watchlists, including a free-tier version and paid-tier variants with more detail or coverage, plus cumulative-performance data for those lists, and crypto watchlists, including a free-tier version and paid-tier variants, plus cumulative-performance data for those lists, and macro research data, and API metadata describing available endpoints and plan requirements; all responses come back as raw JSON from the live API.
When to use it
Useful when you want an assistant to fetch daily ranked market research on stocks, crypto and macro topics inside a chat or coding agent, especially if you already have a Top 5 Stocks API key or only need the free watchlist and metadata tools.
Requirements
Runs locally over stdio via the npm package top5stocks-mcp-server (Node.js, or npx without a local clone). The TOP5STOCKS_API_KEY environment variable is needed only for starter, pro and ultra-tier tools; free tools work without it. Network access to the Top 5 Stocks API is required.
Before you install
Paid-tier tools require the TOP5STOCKS_API_KEY secret, which is placed in the client config; keep it out of shared files. Requests go to a third-party API. The data is educational market research only and is not financial advice, so do not treat it as investment guidance.

Installation

In SourceWeft

  1. Open Top5StocksAPI in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
npm install

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

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):

json
{  "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.

Source: README.md at commit 3221c35

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.6LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.