rmb/omniforce-mcp

Listed on mcprush, Smithery, and the
Official MCP Registry
(io.github.rmb/omniforce-mcp).
A Model Context Protocol (MCP) server for
OmniForce — the GEO & AI-search visibility
platform. It lets any MCP client (Claude Desktop, Cursor, Cline, Continue, …)
audit a site's AI-search readiness and read your tracked prompts, competitors,
visibility runs, and reports without leaving the chat.
> OmniForce helps brands get cited by ChatGPT, Perplexity, Gemini, and Google AI
> Overviews, and tracks AI citations and decay over time — omniforce.run.
## Tools
| Tool | Auth | What it does |
| omniforcegeoscan | none | Audit a URL's GEO/AEO readiness → evidence-based score + findings. |
| omniforcegetbrand | API key | The tenant's brand profile. |
| omniforcelistprompts | API key | Queries monitored across answer engines. |
| omniforcelistcompetitors | API key | Competitors tracked for the tenant. |
| omniforcelistsnapshots | API key | Recent radar runs (citation/visibility snapshots). |
| omniforcelistreports | API key | Shareable visibility reports. |
| omniforceaccount | API key | Plan tier, included allotments, current usage, available upgrades. |
| omniforceupgrade | API key | Create a hosted checkout link to upgrade the plan. |
omniforcegeoscan is keyless — install the server and it works
immediately. The other tools read tenant data and need an API key.
## Quick start
No install required — run it with npx:
jsonc
// Claude Desktop: ~/Library/Application Support/Claude/claudedesktopconfig.json
// Cursor: ~/.cursor/mcp.json
"mcpServers": {
"omniforce": {
"command": "npx",
"args": ["-y", "@omniforce/mcp"],
"env": {
"OMNIFORCEAPIKEY": "omkyourkey"
OMNIFORCEAPIKEY is optional — omit the env block to use only the keyless
omniforcegeoscan tool. Create a key at
omniforce.run.
### VS Code / Cline / Continue
jsonc
"mcpServers": {
"omniforce": {
"command": "npx",
"args": ["-y", "@omniforce/mcp"],
"env": { "OMNIFORCEAPIKEY": "omkyourkey" }
## Configuration
| Env var | Required | Default | Purpose |
| OMNIFORCEAPIKEY | for tenant tools | — | Tenant API key (omk...). |
| OMNIFORCEAPIBASEURL | no | https://api.omniforce.run | Override the API base URL. |
## From source
bash
npm install
npm run build
node dist/index.js # speaks MCP over stdio
npm test # vitest
## Remote (HTTP) endpoint
Run the same tools over Streamable HTTP for registries and hosted clients:
bash
PORT=8080 OMNIFORCEAPIBASEURL=https://api.omniforce.run npm run start:http
# or:
docker build -f Dockerfile.http -t omniforce-mcp-http . && docker run -p 8080:8080 omniforce-mcp-http
POST /mcp — Streamable HTTP (MCP)
GET /health, GET /.well-known/mcp/server-card.json
Auth is per request: send Authorization: Bearer omk... (or x-api-key) to
use the tenant tools. Anonymous callers get the keyless omniforcegeoscan,
rate-limited per IP/day (OMNIFORCEANONDAILYLIMIT, default 10) plus an upsell