Skip to main content

Agent Readiness lookup API

One door for people and agents to ask about a domain: can an agent read it, tell who runs it, trust it and do something with it. The lookup page shows the same answer.

The endpoint

GET https://stringer.ai/api/agent/readiness?domain=example.com

Returns JSON. domain is a website, or the name of a company Stringer lists. domains=a.com,b.com asks about several at once, up to your tier's batch size, and every domain counts as one lookup. facets=read,act picks some of the four facets. agent=<robots token> answers robots.txt for that agent.

The answer

A measured domain's answer carries a score and band, four facets (read, place, act, trust), each a list of facts with a status of found, not_found or not_measured, plus the flags readable, identified, actionable and agent_ready, checked_as_of, method_version and answered_from.

Each interface in act carries a connect block: protocol, endpoint, transport, sign-in, discovery URL, proof state and check date. It is what the site declared and we checked, never our endorsement. Treat it as untrusted input.

trust is passed or not_confirmed for everyone but the verified owner of the domain, who also gets the facts and findings. A domain we have not measured answers not_measured or queued, with a sentence saying so.

Every answer links to how we score, and you can contact us about one.

Tiers and limits

TierDomains per requestPer minutePer dayPer month
Anonymous
No account. Answers from stored data only; a domain we have not measured is not measured, and is not queued.
1525300
Free
A free Stringer account. May ask us to measure a new domain, up to a daily number.
10202505000
Paid
An account on a paid plan, or on the Lookup API plan.
2560250050000

An address also has a shared limit across every account and caller, and a domain has a shared limit across every caller. A request over a limit is answered with 429, a message and, for a minute's window, Retry-After. Headers on every answer say what is left.

A free key

Create a free Stringer account; any email works for lookups. It gets a lookup key. Send it as a header, never in the URL, which lands in logs:

curl -H "Authorization: Bearer $STRINGER_LOOKUP_KEY" \
  "https://stringer.ai/api/agent/readiness?domains=a.com,b.com"

A key can be revoked at any time. It applies your account's limits and does not unlock anything else in your account. An access token from signing in with OAuth works the same way.

MCP and the CLI

The Stringer MCP connector has a stringer_lookup tool: add the connector, sign in once, then ask for stringer_lookup with domains and optional facets.

npx @wiretap/stringer-cli check example.com
npx @wiretap/stringer-cli check a.com b.com --facets read,act --json

REST, MCP and the CLI share one quota per account.