{
  "markdown": "# Orbit Sentinel MCP Server\n\n[![CI](https://github.com/Viventine-Space/orbit-sentinel-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Viventine-Space/orbit-sentinel-mcp/actions/workflows/ci.yml)\n[![Release](https://img.shields.io/github/v/release/Viventine-Space/orbit-sentinel-mcp)](https://github.com/Viventine-Space/orbit-sentinel-mcp/releases/latest)\n[![MCP Registry](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fregistry.modelcontextprotocol.io%2Fv0%2Fservers%2Fio.github.Viventine-Space%252Forbit-sentinel-mcp%2Fversions%2Flatest&query=%24.server.version&label=MCP%20Registry&prefix=v&color=blue)](https://registry.modelcontextprotocol.io/v0/servers/io.github.Viventine-Space%2Forbit-sentinel-mcp/versions/latest)\n[![orbit-sentinel-mcp MCP server](https://glama.ai/mcp/servers/Viventine-Space/orbit-sentinel-mcp/badges/score.svg)](https://glama.ai/mcp/servers/Viventine-Space/orbit-sentinel-mcp)\n[![Go Reference](https://pkg.go.dev/badge/github.com/viventine-space/orbit-sentinel-mcp.svg)](https://pkg.go.dev/github.com/viventine-space/orbit-sentinel-mcp)\n[![License: MIT](https://img.shields.io/github/license/Viventine-Space/orbit-sentinel-mcp)](LICENSE)\n[![MCP Badge](https://lobehub.com/badge/mcp/viventine-space-orbit-sentinel-mcp)](https://lobehub.com/mcp/viventine-space-orbit-sentinel-mcp)\n\nMCP (Model Context Protocol) server for [Orbit Sentinel](https://viventine.com) —\n950K+ space regulatory filings from FCC, ITU, UNOOSA, and FAA-AST,\nqueryable from Claude Desktop, Claude Code, Cursor, or any MCP client.\n\nAn API key is required. Beta access: <https://console.viventine.com>.\n\nThe server is a thin, open-source (MIT) client of the public REST API — nine Go\nfiles, easy to audit before you run it. Run it locally over stdio, or skip the\ninstall entirely and point your client at the hosted remote endpoint (below).\n\n## Install\n\n### Remote (no install)\n\nThe lowest-friction path — no binary, no updates. Point any HTTP-capable MCP\nclient at:\n\n```\nhttps://orbit-sentinel.viventine.com/mcp\n```\n\nTransport is Streamable HTTP (stateless). Two ways to authenticate:\n\n**OAuth (recommended)** — sign in with your Viventine account in the browser; no\nkey to copy or store. In Claude Code:\n\n```bash\nclaude mcp add --transport http orbit-sentinel https://orbit-sentinel.viventine.com/mcp\n```\n\nThen run `/mcp` -> orbit-sentinel -> authenticate. A browser opens for sign-in\nand consent; Claude Code stores the token and refreshes it automatically. The\nsame works as a custom connector in claude.ai / Claude Desktop (Settings ->\nConnectors -> Add custom connector -> paste the URL -> sign in).\n\n**API key** — if you'd rather use a static key (or your client can't do OAuth),\npass your console key as a bearer token:\n\n```bash\nclaude mcp add --transport http orbit-sentinel \\\n  https://orbit-sentinel.viventine.com/mcp \\\n  --header \"Authorization: Bearer <your-key>\"\n```\n\nGet a key / beta access at <https://console.viventine.com>.\n\n**Generic MCP clients** — any Streamable HTTP client works via OAuth 2.1\n(RFC 9728 protected-resource discovery) or an `Authorization: Bearer <key>`\nheader. For a stdio-only client, bridge with\n`npx mcp-remote https://orbit-sentinel.viventine.com/mcp`.\n\n### Claude Desktop (one-click)\n\nDownload [orbit-sentinel-mcp.mcpb](https://github.com/Viventine-Space/orbit-sentinel-mcp/releases/latest/download/orbit-sentinel-mcp.mcpb)\nand double-click it — Claude Desktop installs the extension and prompts for\nyour API key. Bundles macOS (universal), Linux, and Windows binaries.\n\n### Homebrew (macOS — recommended)\n\n```bash\nbrew install --cask viventine-space/tap/orbit-sentinel-mcp\n```\n\nInstalls to `$(brew --prefix)/bin/orbit-sentinel-mcp`, handles the quarantine\nflag for you, and upgrades with `brew upgrade`.\n\n### Manual download\n\nDownload the archive for your platform from the\n[latest release](https://github.com/viventine-space/orbit-sentinel-mcp/releases/latest),\nthen:\n\n```bash\ntar -xzf orbit-sentinel-mcp_*.tar.gz\nmkdir -p ~/bin && mv orbit-sentinel-mcp ~/bin/\n```\n\nmacOS only — the binary is not notarized yet, so clear the quarantine flag once:\n\n```bash\nxattr -d com.apple.quarantine ~/bin/orbit-sentinel-mcp\n```\n\nWindows: unzip and note the full path to `orbit-sentinel-mcp.exe`.\n\n### Build from source\n\n```bash\ngo install github.com/viventine-space/orbit-sentinel-mcp@latest\n```\n\n## Configure\n\nThe server reads two environment variables:\n\n| Variable | Purpose |\n|---|---|\n| `MCP_API_URL` | Orbit Sentinel API base URL (`https://orbit-sentinel.viventine.com`) |\n| `MCP_API_KEY` | Your API key from the console |\n\n**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json`\n(Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`), using the absolute\npath to the binary (`~` is not expanded):\n\n```json\n{\n  \"mcpServers\": {\n    \"orbit-sentinel\": {\n      \"command\": \"/absolute/path/to/orbit-sentinel-mcp\",\n      \"env\": {\n        \"MCP_API_URL\": \"https://orbit-sentinel.viventine.com\",\n        \"MCP_API_KEY\": \"<your-key>\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code** — one command:\n\n```bash\nclaude mcp add orbit-sentinel \\\n  --env MCP_API_URL=https://orbit-sentinel.viventine.com \\\n  --env MCP_API_KEY=<your-key> \\\n  -- ~/bin/orbit-sentinel-mcp\n```\n\nRestart your client; the Orbit Sentinel tools (`research`, `search_filings`,\n`get_entity_profile`, …) appear in the tools menu.\n\n## Releasing (maintainers)\n\nTag and push — GitHub Actions builds and publishes all platforms:\n\n```bash\ngit tag v0.x.y && git push origin v0.x.y\n```\n\nAsset names are version-stable (`orbit-sentinel-mcp_<os>_<arch>.tar.gz`), so\n`releases/latest/download/...` URLs always serve the newest build.\n\nThe Claude Desktop bundle (`orbit-sentinel-mcp.mcpb`) is packed and uploaded\nby the release workflow — the manifest template lives at `mcpb/manifest.json`\n(its `version` is stamped from the tag at pack time).\n\nThen repeat the [Glama release](https://glama.ai/blog/2026-03-15-how-to-make-a-release)\n— it does not auto-update from GitHub, and it gates the quality score on the\nbadge above. On the [Dockerfile admin page](https://glama.ai/mcp/servers/Viventine-Space/orbit-sentinel-mcp/admin/dockerfile),\nthe saved build spec should carry over (build steps install Go and `go build`;\nplaceholder parameters need a dummy `MCP_API_KEY` to satisfy the env schema) —\nclick **Build**, then **Make Release** with the new version. Manual for now;\nconsider Glama API integration next release cycle.\n",
  "bytes": 6454,
  "sha": "8f0fb19a4b2f740da0706ff38ea5a283a9f929a8aaa0af0849a06dde1fc42ee3",
  "repo_slug": "viventine-space/orbit-sentinel-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_viventine_space_orbit_sentinel_e2ba5898/readme"
}