Neo MCP Server

Run AI/ML tasks on Neo's remote backend directly from Claude Code, Cursor, Windsurf, Zed, VS Code, Continue.dev, and OpenAI Codex CLI.

Quickstart

pip install neo-mcp
neo-mcp setup

The setup wizard detects your editors, prompts for your Neo secret key, and writes all config files automatically.

No-install option — hosted endpoint

Point any MCP client directly at the hosted server:

Get your key from the Neo dashboard.

What you need

• Neo account with a secret key (sk-v1-...)
• Python 3.11+ or Docker

No VS Code extension required for task submission and tracking.

What Neo is for

Neo runs AI/ML work on a remote backend so it does not block your local machine:

• Training or fine-tuning models (classification, regression, NLP, computer vision)
• Building AI agents and multi-agent workflows
• RAG pipelines and vector search systems
• LLM integrations and prompt engineering pipelines
• ML data preprocessing and feature engineering

For general coding your assistant works locally — it only routes to Neo for AI/ML tasks.

Example session

You:       "Train a fraud detection model on fraud.csv"
Assistant: Submitting to Neo…
           ⏳ Step 1: Load and preprocess fraud.csv
           ⏳ Step 2: Train XGBoost with cross-validation
           ✅ Step 3: Evaluate — AUC-ROC: 0.94
           Done. Model saved to fraud_model.pkl

Available tools

How it works

neo_submit_task
      │
      ├─ POST /v2/thread/init-chat-direct  →  thread_id
      │         (deployment_type: vscode)
      │
      └─ background poller starts
              │
              ├── GET /v2/thread/status/{thread_id}   (every 3–15 s)
              │         stores status + plan steps in memory
              │
              └── GET /v2/thread/thread-messages      (on COMPLETED)
                        cached for neo_get_messages

All polling uses thread_id — works with NEO_SECRET_KEY auth only. No OAuth required.

Manual registration (Claude Code)

# Local — pip (recommended)
claude mcp add --scope user neo \
  -e NEO_SECRET_KEY=sk-v1-... \
  -- neo-mcp

# Remote — hosted endpoint (no local install)
claude mcp add --transport http neo https://mcp.heyneo.so/mcp \
  --header "Authorization: Bearer sk-v1-..."

See docs/CLIENTS.md for all editors.

Configuration

Troubleshooting