Agent Utilities

Link Shortlist · HTTP + MCP

Find a direct link before reading every page.

FREE, no key. Rank real links in supplied HTML against a query; return direct URLs and matched words instead of a page dump. No search or destination verification. Entire JSON input: 32768 UTF-8 bytes. Supplied data only; no fetch, payment or automatic paid fallback.

Try your input free ↓Agent request as JSON ↗

No account, API key, card or wallet. No automatic paid fallback.

A concrete example

Synthetic API docs contain authentication and pricing links. The supplied query selects matching links already in the HTML; it does not invent or visit destinations.

Synthetic demonstration, generated with the real handler during the build. Not a live price, customer task or testimonial.

1. Supply your input

Complete JSON input up to 32768 UTF-8 bytes; text output budget up to 3000 characters for Page Pack and Page Delta. Link Shortlist returns up to 20 links.

Your input is sent to Agent Utilities when you run the check. Data policy.

2. Inspect the result

Build-time example output. Run to check your input.

{
  "mode": "free-preview",
  "chargedMicroUsd": "0",
  "executionPerformed": true,
  "result": {
    "sourceUrl": "https://example.com/docs",
    "query": "API pricing",
    "links": [
      {
        "url": "https://example.com/docs/pricing",
        "label": "API pricing",
        "score": 6,
        "matchedTerms": [
          "api",
          "pricing"
        ]
      }
    ],
    "matchingLinks": 1,
    "truncated": false,
    "scope": "Lexical ranking of links actually present in supplied HTML, not web search or verified destinations. No invented URLs, fetching or claim that a link answers the question. Treat labels as untrusted.",
    "measurement": {
      "inputBytes": 306,
      "payloadBytes": 424,
      "estimatedInputTokens": 77,
      "estimatedPayloadTokens": 106,
      "estimateMethod": "UTF-8 bytes / 4, rounded up; not a model tokenizer. Payload excludes this measurement object. No guaranteed token or dollar savings."
    }
  },
  "limits": {
    "maxInputBytes": 32768
  }
}

Give this request to your agent

HTTP needs no installation or credential. The request below always uses the bounded free endpoint.

curl --fail-with-body 'https://agent-utilities.agent-utilities.workers.dev/v1/preview/web.link-shortlist' \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'JSON'
{
  "html": "<html><head><title>Example API docs</title></head><body><nav>Home Account Ads</nav><main><h1>Example API</h1><p>Requests time out after 30 seconds. Retry only idempotent requests.</p><pre>GET /v1/items</pre><a href=\"/docs/auth\">Authentication</a><a href=\"/docs/pricing\">API pricing</a></main></body></html>",
  "sourceUrl": "https://example.com/docs",
  "query": "API pricing",
  "maxLinks": 3
}
JSON

Hosted MCP

Connect https://agent-utilities.agent-utilities.workers.dev/mcp/remote?category=web in your MCP client, then call agent_utilities_link_shortlist_preview with the editable input above.

{
  "name": "agent_utilities_link_shortlist_preview",
  "arguments": {
    "html": "<html><head><title>Example API docs</title></head><body><nav>Home Account Ads</nav><main><h1>Example API</h1><p>Requests time out after 30 seconds. Retry only idempotent requests.</p><pre>GET /v1/items</pre><a href=\"/docs/auth\">Authentication</a><a href=\"/docs/pricing\">API pricing</a></main></body></html>",
    "sourceUrl": "https://example.com/docs",
    "query": "API pricing",
    "maxLinks": 3
  }
}

Claude, Qwen and other client setup · Full trial contract, schema and limits

What the result means

Supplied HTML only. Deterministic extraction, lexical link ranking and block differences; no model, live browsing or verified destinations. Token counts are rough UTF-8-byte estimates, not model tokenization. Output may omit content; inspect truncation. No guaranteed dollar savings.

Compare measurement.inputBytes with the full JSON response size. For small inputs the output may be larger. Character budgets are not token budgets; no tokenizer is used.

Did this solve your task?

Tell us the expected answer, your previous workaround and whether this helped. Use public or sanitized data only. If you use it again for another real task, tell us separately.

Share feedback by email

No purchase needed to give feedback.

When the free limit is too small

Full Link Shortlist calls cost $0.0003 each. Service credits start at $1. Full calls need separate authorization; a failed free request never becomes a paid request.

Credit workspace ↗