# alphadesk-terminal

Gives your agent quotes, news, SEC filings and US Treasury records through 53 read-only tools, running on your own vendor keys.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 20
- Author: vigneshv1cky
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vigneshv1cky/alphadesk-terminal
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/alphadesk-terminal

## What it does

This server lets an agent read the market instead of guessing at it: quotes and charts, news feeds, SEC EDGAR documents, financial statements, insider activity, earnings calendars, options and crypto. It trades nothing, holds nothing and writes no summaries. You ask questions in your own agent and it pulls the records through MCP tools.

SEC EDGAR and Treasury data are public. Everything else needs keys from your own market-data and news providers, which you supply. Install is a single `uvx` line, with no account and no database. Without vendor keys the paid feeds stay empty, so that is the one thing to line up first.

Read-only is the whole design. If you want an agent to place orders or book trades, this is the wrong tool and no setting changes that.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add alphadesk-terminal -- uvx alphadesk
```
uvx runs the command named after the package; if the README names another one, use uvx --from alphadesk <command>

### Codex

**Platform CLI**
```bash
codex mcp add alphadesk-terminal -- uvx alphadesk
```
uvx runs the command named after the package; if the README names another one, use uvx --from alphadesk <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "alphadesk-terminal": {
            "command": "uvx",
            "args": [
                "alphadesk"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from alphadesk <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "alphadesk-terminal": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "alphadesk"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from alphadesk <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add alphadesk-terminal uvx alphadesk
```
uvx runs the command named after the package; if the README names another one, use uvx --from alphadesk <command>

## When to use it
- pull a ticker's quote and chart inside an agent chat
- grab a company's latest filing from SEC EDGAR
- check insider transactions for a stock
- list earnings dates for the coming week
- inspect an options chain by expiry

## Example prompts
- Show me NVDA quotes and a chart for the last month.
- Find the latest 10-K for this company on SEC EDGAR and pull the annual revenue.
- Which earnings reports land next week for my watchlist?

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

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