@genready/mcp-server
Connect GenReady to your AI assistant or coding agent. Scan any page for readiness to be cited by AI search engines and used by AI agents, then hand the fix checklist straight to your agent.
1. Get an API key
Create one at genready.ai/api-keys. To read site-wide fix plans, enable Read site data (domain:read) when you create it.
2. Connect
Remote (recommended, nothing to install)
Any client that supports remote MCP servers over Streamable HTTP can connect directly:
- URL:
https://genready.ai/mcp
- Header:
Authorization: Bearer gr_live_your_key_here
Claude Code:
claude mcp add --transport http genready https://genready.ai/mcp \
--header "Authorization: Bearer gr_live_your_key_here"
Cursor (.cursor/mcp.json):
{
"mcpServers": {
"genready": {
"url": "https://genready.ai/mcp",
"headers": { "Authorization": "Bearer gr_live_your_key_here" }
}
}
}
Local command (stdio)
For clients that only launch local commands, such as Claude Desktop:
{
"mcpServers": {
"genready": {
"command": "npx",
"args": ["-y", "@genready/mcp-server"],
"env": { "GENREADY_API_KEY": "gr_live_your_key_here" }
}
}
}
This package forwards to the hosted endpoint, so both options expose the same tools.
3. Ask
Scan https://example.com for AI readiness and fix what you can in this repo.
| Tool | What it does | Credits |
|---|
analyze_website | Scan a URL. Returns scores and the fix checklist. scope: full, content, crawlability. | 1 per scan |
get_report | Read a report by ID, including its fix checklist. | Free |
check_status | Progress of a scan started with wait: false. | Free |
list_reports | Your past reports. | Free |
get_usage | Plan, credits used and remaining. | Free |
list_domains | Your monitored domains (needs domain:read). | Free |
get_fix_plan | Ranked site-wide fixes from a domain's latest site analysis (needs domain:read). | Free |
The fix checklist is included on Pro and Agency plans. On other plans, reports say it is locked.
Environment variables (stdio)
| Variable | Required | Description |
|---|
GENREADY_API_KEY | Yes | Your API key (starts with gr_live_) |
GENREADY_MCP_URL | No | Hosted MCP endpoint (default https://genready.ai/mcp) |
Links