io.github.Top5StocksAPI/mcp-server
Daily AI-ranked stock, crypto, and macro research data from the Top 5 Stocks API.
Open source Open in the app JSON README (API)
About
Daily AI-ranked stock, crypto, and macro research data from the Top 5 Stocks API.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- top5stocksapi
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.6
- Last push
- 2026-07-13T22:51:18Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 03:02:17
- Updated
- 2026-08-29 03:02:17
- Origin id
io.github.Top5StocksAPI/mcp-server
README
# Top 5 Stocks MCP Server
Exposes the [Top 5 Stocks API](https://top5stocks.netlify.app/developers) 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.