# AshutoshRaj97/agentready-mcp [Health: Active]

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://github.com/AshutoshRaj97/agentready-mcp  
**GitHub Stars:** 2  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ashutoshraj97-agentready-mcp

## Description
Make any website queryable by AI agents. Index a site then ask questions and get cited answers grounded in its content via RAG. Tools: listsites and asksite. npx -y @agentreadyweb/mcp

## Tools
Capabilities this server exposes over MCP:

- **list_sites** — List all websites currently indexed in AgentReady. Use this to check if a domain is already available before submitting it — indexed sites return instant cited answers via ask_site. The index covers developer tools, APIs, cloud platforms, frameworks, databases, and more, and grows as new sites are submitted.
- **get_site_capabilities** — Return the AgentReady capability manifest for a website. If the site is not indexed yet, AgentReady indexes it automatically before returning its freshness, read-only limits, schemas, and available MCP and HTTP endpoints.
- **plan_site_action** — Turn a natural-language request into a grounded, read-only AgentReady plan for a website. If the site is not indexed yet, AgentReady indexes it automatically first. This prototype never executes side effects; it identifies supported steps, sources, risks, and whether a future execution would require confirmation.
- **submit_site** — Index any website so it can be queried with ask_site. Use this when the site is not yet in list_sites. Handles JS-rendered pages (React, Next.js, Vue SPAs) that web_fetch cannot read — uses a four-layer pipeline: llms.txt → HTTP+cheerio → __NEXT_DATA__ extraction → Jina Reader headless browser. Takes ~60 seconds. Once indexed, ask_site queries are instant.
- **ask_site** — Query any website's documentation and get cited, multi-page answers in natural language. Use ask_site when you need: (1) answers that synthesize information across multiple pages of a site, (2) documentation from JS-rendered sites (React, Next.js, Vue SPAs) where web_fetch returns empty or partial HTML, (3) citations linking back to the exact source pages, (4) faster results than fetching and reading individual pages one by one. For sites not yet indexed, ask_site auto-crawls and answers in ~60s — no separate submit_site call needed.
- **refresh_site** — Force a full re-crawl of a site to pick up new or changed content. If the site has never been indexed, AgentReady performs the initial indexing automatically. Use when ask_site returns outdated information or when you know the site has recently been updated. Takes ~60 seconds. After completion, ask_site returns fresh content.
- **rate_answer** — Rate the quality of a previous ask_site answer from 1 (not useful) to 5 (excellent). Pass the request_id returned in structuredContent when available so the rating can be tied to the exact answer.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "agentready-mcp": {
    "command": "npx",
    "args": ["-y","@agentreadyweb/mcp"]
  }
}
```

## Documentation

## What AshutoshRaj97/agentready-mcp MCP server does

AshutoshRaj97/agentready-mcp MCP server connects an MCP-compatible agent to AgentReady, a hosted service for indexing and querying public websites. An agent can check which domains are already available, submit a new site, and ask natural-language questions about its indexed content. Answers are grounded in the crawled pages and include citations to source URLs.

The service is aimed at documentation and other public web content. It can work with static sites, server-rendered pages, and JavaScript-heavy applications such as React, Next.js, Vue, Docusaurus, and GitBook sites. It does not index sites that require authentication or provide no usable public HTML content.

## How it works

When a site is submitted, AgentReady first looks for `llms.txt` or `llms-full.txt`. If those are unavailable, it performs an HTML crawl using a sitemap or discovered links, extracting up to 10 pages. Next.js data embedded in `__NEXT_DATA__` can provide another source, and a Jina Reader rendering fallback handles pages whose useful content appears only after JavaScript runs.

Indexing usually takes about 60 seconds. Once complete, `ask_site` can synthesize information from multiple pages without requiring the agent to fetch each page separately. A new domain can also be indexed automatically when an agent asks a question, checks capabilities, or creates a plan.

AshutoshRaj97/agentready-mcp MCP server does not execute actions against the indexed website. Its planning feature returns supported steps, evidence, risks, confirmation requirements, and a receipt for a future operation, while remaining read-only. Use `refresh_site` when content has changed or an answer appears stale.

## Setup and configuration

Run the local MCP bridge with:

```bash
npx -y @agentreadyweb/mcp
```

MCP clients using stdio configure `npx` as the command and pass `-y` and `@agentreadyweb/mcp` as arguments. The README gives configurations for Cursor, VS Code agent mode, Windsurf, and other stdio-compatible clients. A client supporting HTTP transport can instead connect to `https://www.agentready.it.com/api/mcp` without installing the npm package.

No account is required to index the first site. The material does not specify environment variables or API credentials for the MCP bridge.

## Tools and capabilities

The available operations include:

- `list_sites`: view indexed domains, titles, and page counts.
- `get_site_capabilities`: inspect freshness, schemas, endpoints, and read-only limits.
- `get_site_facts`: retrieve structured facts such as pricing tiers, features, and limits.
- `plan_site_action`: produce an evidence-backed, non-executing plan.
- `submit_site`: index a public URL.
- `ask_site`: ask questions and receive cited answers, with optional URL scoping.
- `refresh_site`: perform a full re-crawl.
- `rate_answer`: submit a quality score from 1 to 5, optionally linked to a request ID.

The same package also provides CLI commands for grading a site's agent readiness, asking questions, indexing, and refreshing. JSON output is available for CLI automation, and the grading command can be used as a CI check.

## Limitations and notes

AshutoshRaj97/agentready-mcp MCP server depends on AgentReady's hosted indexing and retrieval service. Crawling is not instantaneous, particularly for a new or refreshed domain. Sites behind authentication or without public HTML content are outside the documented indexing scope.

The plan operation is deliberately read-only and does not perform side effects. The README also documents a deploy webhook for triggering refreshes; it is rate-limited to once per hour per domain and requires no authentication. For Docusaurus, MkDocs, Starlight, or Sphinx documentation sites, separate plugins or extensions can trigger indexing during builds, but these are additional integrations rather than part of the MCP bridge itself.

_Full upstream README: https://allmcps.com/mcp/ashutoshraj97-agentready-mcp/readme_