Quick Start

Get up and running with Ray9 in under 60 seconds — MCP server, REST API, or CLI.

Get Your API Key

Sign up at ray9.ai/signup to get your free API key. No credit card required. The free tier starts immediately with 1,000 requests/month (any type).

Choose Your Access Method

Option 1: MCP Server

Add Ray9 to your MCP client (Claude Desktop, Cursor, VS Code, Windsurf, Goose, etc.):

{
  "mcpServers": {
    "ray9": {
      "command": "npx",
      "args": ["-y", "@ray9/mcp"],
      "env": {
        "RAY9_API_KEY": "ry9_live_your_key_here"
      }
    }
  }
}

Then ask your AI assistant:

"How is our domain showing up in ChatGPT and Perplexity for 'best crm' queries?"

Option 2: CLI

Install the CLI globally:

npm install -g @ray9/cli

# Authenticate
ray9 auth login

# SERP with AI-engine overlay
ray9 serp "best crm" --engine google --ai-engines chatgpt,perplexity,aio

# Keyword ideas
ray9 keywords ideas "ai agents" --country US

# Backlinks
ray9 backlinks list example.com --limit 100

# AI-search visibility
ray9 geo visibility example.com --engines chatgpt,perplexity,aio

Option 3: REST API

Make a direct API call:

curl https://api.ray9.ai/v1/keywords/ideas \
  -H "Authorization: Bearer ry9_live_your_key_here" \
  -d '{"seed":"ai agents","country":"US"}'

Response:

{
  "seed": "ai agents",
  "ideas": [
    { "keyword": "ai agents platform", "volume": 22100, "kd": 38, "intent": "commercial" },
    { "keyword": "best ai agents 2026", "volume": 14800, "kd": 42, "intent": "informational" }
  ]
}

What's Next

Explore the full documentation for all available endpoints and features