agentfit

agentfit

Is your website ready for AI agents? agentfit asks the AgentReady service for its free preview of a site: a 0-100 score, an A-F grade and category scores covering things like agent access, readable content, discovery and agent interfaces. The score is the upstream's — nothing is computed, trimmed, renamed or summarised locally; the response body comes back exactly as the service returned it.

Free tier only — the paid surface is omitted

AgentReady also offers x402-paid routes (/v1/lite at $0.005 and /v1/audit at $0.03, paid in USDC), and its original stdio server pays for the full audit per call when a wallet private key is supplied through AGENTREADY_X402_PRIVATE_KEY. This rebuild implements none of that. It calls only the documented free route, GET /v1/preview?url=, which is the original server's own default behaviour without the key. The paid routes and the wallet-key mode are omitted entirely: this build holds no payment instrument, never reads AGENTREADY_X402_PRIVATE_KEY or any other wallet or payment environment variable, and never sends an Authorization header.

The free preview is limited upstream to 10 requests per minute per IP; a 429 (like any other non-2xx reply) surfaces as agentready error: HTTP 429.

Configuration

Two environment variables control the client (both are this rebuild's own, labelled):

• AGENTREADY_API_URL (optional) — API base URL. Defaults to https://api.youraitools.co/agentready; a trailing slash is stripped.
• AGENTREADY_TIMEOUT_MS (optional) — per-request timeout in milliseconds, enforced with an AbortController. Defaults to 30000.

Tools

• audit_website — is this website ready for AI agents? Returns the free preview: a 0-100 score, an A-F grade and category scores. Takes one required argument, url (the documented REST parameter; the MCP-layer argument name is a labelled reconstruction, because the hosted MCP endpoint did not answer during spec capture).

An upstream non-2xx reply fails with agentready error: HTTP <status> — that is how the upstream's 400 (bad, private or internal URL), 422 (unresolvable host) and 429 (preview rate limit) answers surface. An unreachable service, including a timeout, fails with agentready unreachable.

CLI

The tool is a subcommand taking one JSON argument string:

npx @reneturcios/agentfit audit_website '{"url":"https://example.com"}'
npx @reneturcios/agentfit --version

Output is the tool's result text (the upstream body on success). Exit codes: 0 on success, 1 on a runtime error, 2 on a usage error.

MCP server

npx -y @reneturcios/agentfit mcp

MCP client config:

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

Docker

docker run -i ghcr.io/cloudcorprecords/agentfit
docker run --rm ghcr.io/cloudcorprecords/agentfit audit_website '{"url":"https://example.com"}'

Development

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

License

MIT — Copyright (c) 2026 Rene Turcios