MCP server

npx -y orbit-mcp → gives Claude (or any MCP client) orbit_search, orbit_status, orbit_export.

orbit-mcp is an MCP server that gives Claude Code (or any MCP client) three tools: search Orbit, check a project, and export results. It wraps @orbit/sdk — no data lives in the package itself.

Install

You need an Orbit API key from Settings → API keys, and your deployment origin.

claude mcp add orbit \
  --env ORBIT_API_KEY=ok_live_… \
  --env ORBIT_API_URL=https://<deployment>.convex.site \
  -- npx -y orbit-mcp

Or in your MCP client config:

{
  "mcpServers": {
    "orbit": {
      "command": "npx",
      "args": ["-y", "orbit-mcp"],
      "env": {
        "ORBIT_API_KEY": "ok_live_…",
        "ORBIT_API_URL": "https://<deployment>.convex.site"
      }
    }
  }
}

Node ≥ 20. Speaks MCP over stdio.

Tools

orbit_search

Submit a brief, wait for results, optionally export.

Argument	Type	Notes
`brief`	string	Who to find. Include a count: `"find 30 …"`
`maxResults`	number?	Convenience target appended to the brief
`waitMs`	number?	Poll timeout before returning a still-running summary (default 120 000)
`format`	`"md" \| "json" \| "csv"` ?	Export on completion
`outputDir`	string?	Where to write the export (default: current directory)
`openObsidian`	boolean?	For `md`, open Obsidian when installed (default true)

orbit_status

orbit_status(projectId)

One-shot project status: counts, done flag, any clarification question.

orbit_export

orbit_export(projectId, { format, outputDir?, openObsidian? })

Write finished results to disk:

md — one <full-name>.md per person + an _index.md hub for Obsidian graph view
json — single results.json
csv — single results.csv, byte-identical to Orbit's in-app export

2-minute demo

You:    Find senior ML engineers at fintech startups in Berlin,
        export to markdown in ./berlin-ml, open in Obsidian.

Claude: [calls orbit_search { brief: "...", format: "md", outputDir: "./berlin-ml" }]
        → one note per person + _index.md → Obsidian graph view.

If you use Claude Code, consider the Claude Code plugin instead — it wraps a hosted remote MCP server and uses OAuth, so there's no API key to manage. See Claude Code plugin.