@mirage-cli/seogets-cli

CLI for the SEO Gets MCP — typed Commander subcommands over the upstream MCP JSON-RPC server.

bun add -g @mirage-cli/seogets-cli
export SEOGETS_MCP_TOKEN=...

seogets tools                                         # list MCP tools
seogets sites                                         # GSC properties for this token
seogets gsc example.com 2026-04-01 2026-04-29 query,page
seogets indexing overview example.com
seogets indexing status example.com --status "Crawled - currently not indexed"
seogets call get_gsc_performance '{"site":"example.com","start_date":"2026-04-01","end_date":"2026-04-29","page":1}'

Auth

SEOGETS_MCP_TOKEN env var (required) — find it in your SEO Gets account under MCP/API settings.

Optional: SEOGETS_MCP_URL overrides the endpoint (default https://app.seogets.com/mcp).

Or pass --token <token> / --url <url> to any command.

Transport

JSON-RPC 2.0 over Streamable HTTP. The endpoint returns SSE-encoded responses (event: message / data: {...}) — the CLI parses the data: line automatically.

Output

Every command supports -f, --format <fmt> (ascii | json | csv | markdown | ndjson) and -o, --output <file>.

Programmatic use

import { buildProgram, McpClient } from "@mirage-cli/seogets-cli";

// CLI form
await buildProgram().parseAsync(["node", "seogets", "sites", "--format", "json"]);

// Direct MCP client
const c = new McpClient({ token: process.env.SEOGETS_MCP_TOKEN });
const sites = await c.callTool("list_sites", { filter: "all" });

Drop-in for mirage: see @mirage-cli/seogets.