# NEUM

This MCP server for Claude Code brings NEUM data on US stock levels and events into an AI assistant. It can retrieve level history, upcoming earnings and watchlist details.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: neum-trade
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/neum-trade/neum-mcp
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/neum

## What it does

NEUM gives an AI assistant access to US stock price levels, model events and earnings dates. The server can also retrieve recent level history and published model records, then list upcoming events. Watchlists can be edited or switched; NEUM asks for confirmation before applying a change.

The server runs remotely over HTTP and requires sign-in through NEUM. An active NEUM plan is required. It cannot place trades or transfer money, and it does not receive assistant conversations. NEUM keeps app request logs for 90 days.

In Claude Code, add the server with `claude mcp add --transport http neum https://api.neum.trade/mcp`, then open `/mcp` and authenticate. The repository holds documentation; NEUM hosts the server.

## Requirements
- Remote server: `https://api.neum.trade/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.neum.trade/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add neum --url https://api.neum.trade/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "neum": {
            "url": "https://api.neum.trade/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "neum": {
            "type": "http",
            "url": "https://api.neum.trade/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http neum https://api.neum.trade/mcp
```

## When to use it
- retrieve current price levels for US stock tickers
- find watchlist tickers with recent level crossings
- check upcoming earnings and other ticker events
- edit or switch the active watchlist

## Example prompts
- Show the current levels for NVDA and AMD.
- Which tickers on my watchlist crossed a level this week?
- Add SBUX to my Tech list.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
