# mcp-server

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/Top5StocksAPI/mcp-server  
**npm Downloads (last month):** 1232  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-server-77

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

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "mcp-server": {
    "command": "npx",
    "args": ["-y","mcp-server-77"]
  }
}
```

## Documentation & 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.