Skip to main content
Glama
README.md
# 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:

```bash
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

```bash
npx -y @reneturcios/agentfit mcp
```

MCP client config:

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

## Docker

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

## Development

```bash
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