# AgentRead

> Web pages to clean Markdown for AI agents. 5 free calls/day, then pay per call via x402 on Base.

- name: io.github.omarhassanatef/agentread
- version: 0.2.0
- connection class: R0 (autonomous)
- trust: 97/100
- quality: 85/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.omarhassanatef%2Fagentread
- tools: https://api.protogrid.dev/v1/servers/io.github.omarhassanatef%2Fagentread/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "agentread": {
      "type": "http",
      "url": "https://agentread.omar-cv.workers.dev/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 99
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website +reachable +uptime-98% +updated-14d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 85/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 3 of 3 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: inspect_url (destructiveHint); extract_url (destructiveHint, idempotentHint); extract_url_structured (destructiveHint, idempotentHint)
- pass `tools.token_cost`: about 768 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 2 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 3, about 768 tokens to load them all
- tool set hash: c3bbb981707763d774b6a7e51cd5ee1f
- tools last changed: 2026-10-24T13:43:05.558Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.omarhassanatef/agentread.svg)](https://protogrid.dev/servers/io.github.omarhassanatef/agentread)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-24 `extract_url_structured` changed (description)
  - before: Fetch a public web page and return structured data: page metadata (title, description, canonical URL, language, site name, byline), main content Markdown, ordered headings with levels, and links (text + URL). Deterministic HTML processing, no LLM. Paid via x402 ($0.005 per successful call). Returns JSON with schemaVersion, operation, requestedUrl, finalUrl, metadata{title,description,canonicalUrl,language,siteName,byline,publishedTime}, markdown, headings, headingsTruncated, links[{text,url}], linksTruncated, truncated, extraction{...}.
  - after: Fetch a public web page and return structured data: page metadata (title, description, canonical URL, language, site name, byline), main content Markdown, ordered headings with levels, and links (text + URL). Deterministic HTML processing, no LLM. Paid via x402 ($0.005 per successful call; the first 5 successful calls per day are free). Returns JSON with schemaVersion, operation, requestedUrl, finalUrl, metadata{title,description,canonicalUrl,language,siteName,byline,publishedTime}, markdown, headings, headingsTruncated, links[{text,url}], linksTruncated, truncated, extraction{...}.
- 2026-10-24 `extract_url` changed (description)
  - before: Fetch a public web page and return its main content as clean Markdown with title, description, headings and extraction metadata. Removes navigation, ads, cookie banners and scripts. Does not execute JavaScript. Paid via x402 ($0.003 per successful call). Returns JSON (structuredContent + text) with schemaVersion, operation, requestedUrl, finalUrl, title, description, markdown, headings[{level,text}], truncated, extraction{method,statusCode,contentType,charset,redirects,bytesFetched,characters,totalCharacters,words,warnings,durationMs}.
  - after: Fetch a public web page and return its main content as clean Markdown with title, description, headings and extraction metadata. Removes navigation, ads, cookie banners and scripts. Does not execute JavaScript. Paid via x402 ($0.003 per successful call; the first 5 successful calls per day are free). Returns JSON (structuredContent + text) with schemaVersion, operation, requestedUrl, finalUrl, title, description, markdown, headings[{level,text}], truncated, extraction{method,statusCode,contentType,charset,redirects,bytesFetched,characters,totalCharacters,words,warnings,durationMs}.

Full history: https://api.protogrid.dev/v1/servers/io.github.omarhassanatef%2Fagentread/changes

## Remotes

- https://agentread.omar-cv.workers.dev/mcp (streamable-http, auth none, reachable true, uptime30d 0.98275864)

## Packages

_none_

## Tools (3)

- `extract_url`: Fetch a public web page and return its main content as clean Markdown with title, description, headings and extraction metadata. Removes navigation, ads, cookie banners and scripts. Does not execute JavaScript. Paid via x402 ($0.003 per successful call; the first 5 successful calls per day are free). Returns JSON (structuredContent + text) with schemaVersion, operation, requestedUrl, finalUrl, title, description, markdown, headings[{level,text}], truncated, extraction{method,statusCode,contentType,charset,redirects,bytesFetched,characters,totalCharacters,words,warnings,durationMs}.
- `extract_url_structured`: Fetch a public web page and return structured data: page metadata (title, description, canonical URL, language, site name, byline), main content Markdown, ordered headings with levels, and links (text + URL). Deterministic HTML processing, no LLM. Paid via x402 ($0.005 per successful call; the first 5 successful calls per day are free). Returns JSON with schemaVersion, operation, requestedUrl, finalUrl, metadata{title,description,canonicalUrl,language,siteName,byline,publishedTime}, markdown, headings, headingsTruncated, links[{text,url}], linksTruncated, truncated, extraction{...}.
- `inspect_url`: Free, lightweight check of a public URL: reachability, HTTP status, final URL after redirects, content type, page title, and whether extraction is likely to work. Downloads at most a small prefix of the page.