Agentready Mcp

by AshutoshRaj97

199 downloads
Not rated
GitHub

About

Make any website queryable by AI agents — index any site, ask questions, get cited answers via RAG

Details

Author
AshutoshRaj97
Downloads
199
Categories
Search, Other, Knowledge Base

- Index any website for AI querying.
- Answer questions with cited sources.
- Uses RAG for retrieval-augmented generation.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Agentready Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

get_site_facts

Return structured facts extracted from a website — pricing, limits, features, contact info, and more. Facts marked as "owner-verified" have been explicitly attested by the site owner and are guaranteed accurate ground truth; use these in preference to scraped RAG answers for critical comparisons. Ideal for price comparison across multiple sites, feature matrix lookups, or any task where you need structured data rather than a natural-language synthesis.

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 / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

AgentReadyis a hosted capability layer that makes any website discoverable and usable by agents through MCP.

Paste a URL → AgentReady crawls the site, generates a spec-compliantllms.txt, and hosts a live/askRAG endpoint and MCP server. Any MCP-compatible agent client can then discover the site, ask natural-language questions, inspect capabilities, and create grounded read-only plans with citations.

The problem it solves:AI agents usingweb_fetchfetch one page at a time, get empty HTML from JavaScript SPAs (React, Next.js, Vue), and hallucinate when the answer spans multiple pages. AgentReady indexes the whole site, handles JS rendering, and retrieves across pages — so agents get the right answer instead of a confident wrong one.

What's already indexed:Browse the liveAgentReady directory →or index any public site yourself.

- Works on any public URL — static sites, React/Next.js SPAs, Docusaurus, GitBook, custom engines
- No account required to index your first site
- Shared index — one team member submits a site, everyone on the team can query it instantly
- Handles JS-rendered pages thatweb_fetchreturns empty for
- Capability manifests expose freshness, schemas, endpoints, and read-only limits
- Grounded plans return evidence, risks, confirmation requirements, and durable receipts

The same package doubles as a CLI — no install, no account:

# Agent-readiness report card (llms.txt, sitemap, robots, JS-rendering, index status) npx @agentreadyweb/mcp grade yourdocs.com # Ask any site a question, get a cited answer (auto-indexes new sites in ~60s) npx @agentreadyweb/mcp ask stripe.com "what is the test card number?" # Index or re-crawl a site npx @agentreadyweb/mcp index yourdocs.com npx @agentreadyweb/mcp refresh yourdocs.com

For CI, dashboards, or scripts, add--jsonto receive the raw report on stdout (progress remains on stderr):

npx @agentreadyweb/mcp grade yourdocs.com --json | jq '.grade, .score'

The command still exits1when the grade is belowB.

gradeexits non-zero below a B, so you can use it as a CI gate.refreshin your docs deploy pipeline keeps the index fresh automatically:

# GitHub Actions — after your docs deploy step - run: npx @agentreadyweb/mcp refresh yourdocs.com

Connect any MCP-compatible client to AgentReady:

For clients that use anmcpServersconfiguration, add the AgentReady bridge:

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

Restart your client. You'll have eight tools available:

- list_sites— see all indexed websites
- get_site_capabilities— index on demand, then inspect a site manifest, freshness, schemas, and endpoints
- get_site_facts— key structured facts extracted from a site
- ask_site— query any site with cited, multi-page answers
- plan_site_action— index on demand, then create a grounded, read-only plan and receipt
- submit_site— index any website so it can be queried
- refresh_site— re-crawl a site, or perform its initial index when it is new
- rate_answer— submit quality feedback

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

Or add the sameagentreadyserver to your client's project configuration to share it with your team:

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

Requires VS Code 1.99+ with the GitHub Copilot extension. Create.vscode/mcp.jsonin your project root:

{ "servers": { "agentready": { "type": "stdio", "command": "npx", "args": ["-y", "@agentreadyweb/mcp"] } } }

Copilot's MCP tools are only available in agent mode. Commit this file to share with your team.

Any MCP client that supports stdio transport works the same way — usenpx -y @agentreadyweb/mcpas the command.

If your client supports HTTP transport, connect directly by URL — no npm required:

If your docs site uses Docusaurus, auto-index on every build:

npm install @agentreadyweb/docusaurus-plugin
// docusaurus.config.js plugins: [ ['@agentreadyweb/docusaurus-plugin', { domain: 'docs.yoursite.com' }] ]

If your docs site uses MkDocs, auto-index on every build:

# mkdocs.yml plugins: - search - agentready

Ifsite_urlis not set, specify the domain explicitly:

plugins: - agentready: domain: docs.yoursite.com

If your docs site uses Starlight (Astro), auto-index on every build:

// astro.config.mjs import agentready from 'starlight-agentready' export default defineConfig({ site: 'https://docs.yoursite.com', integrations: [ starlight({ plugins: [agentready()], }), ], })

If your docs site uses Sphinx, auto-index on every build:

# conf.py extensions = [ "sphinx_agentready.extension", ] # Domain is inferred from html_baseurl automatically, or set explicitly: agentready_domain = "docs.yoursite.com"

Lists all websites currently indexed by AgentReady with their titles and page counts. Use this to check if a domain is already available before submitting it.

Returns the site's capability manifest, freshness state, schemas, and available HTTP/MCP endpoints.

Returns key structured facts extracted from a site — pricing tiers, feature lists, limits, and other high-signal data points that agents frequently need.

plan_site_action(domain: string, request: string)

Creates a grounded, read-only plan with evidence, risks, confirmation requirements, and a durable receipt. It does not execute side effects.

Index any website with AgentReady. Takes ~60 seconds. Handles static sites, server-rendered pages, and JavaScript-heavy SPAs via a four-layer pipeline. Once done, query it withask_site.

Example:submit_site("https://docs.example.com")

ask_site(domain: string, query: string, url?: string)

Ask a question about any website and get a cited answer grounded in its content. Synthesises information across multiple pages. If the site isn't indexed yet, AgentReady crawls and indexes it automatically before answering (~60s).

Example:ask_site("stripe.com", "What are the fees for card payments?")

Force a full re-crawl of a site to pick up new or changed content. If the site is new, AgentReady performs its initial index automatically. Takes ~60 seconds.

Example:refresh_site("docs.example.com")

rate_answer(domain: string, rating: number, request_id?: string, comment?: string)

Submits 1–5 quality feedback, optionally tied to the exactask_siterequest.

Automatically re-index your docs on every deploy. No auth required — rate limited to once per hour per domain.

curl -X POST https://www.agentready.it.com/api/webhook/refresh \ -H "Content-Type: application/json" \ -d '{"domain": "docs.yoursite.com"}'

Or pass the domain as a query param (works with Vercel/Netlify form-encoded webhook payloads):

https://www.agentready.it.com/api/webhook/refresh?domain=docs.yoursite.com

AgentReady uses a layered approach to handle any public website:
- llms.txt / llms-full.txt— if the site publishes one, it's used as a high-quality structured content source
- Standard HTML crawl— fetches up to 10 pages via sitemap or link crawling, extracts clean text
- __NEXT_DATA__extraction— for Next.js apps, parses server-side rendered data embedded in the HTML
- Jina Reader fallback— for JS-only SPAs that return empty HTML, uses a remote rendering service to extract content

Sites behind authentication or with no public HTML content cannot be indexed.

This package sends a lightweight anonymous ping toagentready.it.com/api/telemetryeach time the MCP bridge starts or a CLI command runs. It contains: a random install ID (stored in~/.agentready/install-id), package version, Node version, platform, and which mode/command was used. No query content, no domain names, no personal data. SetAGENTREADY_TELEMETRY=0to opt out.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Creates a personal, always-current knowledge base for AI by indexing documentation from websites, GitHub, npm, PyPI, and local files.

Performs a local RAG search on your query using live web search for context extraction.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.

MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.

At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.

RAG Search over your content powered by Inkeep

Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.