Quickstart

From zero to your first GEO score briefing in about five minutes. You need a geOracle account (free) and one of the supported agents.

Prerequisites

A geOracle account (sign up free)
Claude Code, Cursor or Codex CLI installed
Your production site URL

1. Get your key

Run the setup wizard and choose MCP, or mint a key in Team settings. Keys are shown once: copy it somewhere safe.

2. Add the server to your agent

Pick your client. The command adds the geOracle MCP server with your key as a header.

terminal

claude mcp add --transport http georacle https://georacle.ai/api/mcp --header "Authorization: Bearer YOUR_KEY"

Claude Code

/plugin marketplace add georacle/claude-plugin
/plugin install georacle@georacle
/georacle:setup

Install the geOracle plugin in Claude Code and /georacle:setup wires all of this, including the weekly routine.

3. Verify the connection

Ask your agent to call get_dashboard_summary, or use the Test connection button in the wizard. A successful call appears in your dashboard within seconds.

4. Run your first workflow

In Claude Code, install the plugin and run /georacle:setup for the guided path (site connection, first optimization, weekly routine). Or just ask your agent to connect your site and score your three weakest pages.

Troubleshooting

401 Unauthorized: The key is wrong, revoked or missing the mcp scope. Mint a fresh key in Team settings and update your client config.
payment_required on a tool: That tool is on the paid tier. The free tier covers analysis and scoring; upgrade in the wizard or use your PRO or ENTERPRISE plan's included access.
Timeouts on get_site_snapshot: Large sites analyze asynchronously. The tool returns a job id; your agent polls it. This is normal.
stale_briefing on submit: The content changed between briefing and submission. Fetch a fresh briefing and resubmit.

Next steps

Read the getting-started resource your agent can see (georacle://docs/getting-started)
Set up the weekly routine with /georacle:setup
Open your dashboard to review what your agent submits