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
| Tier | Domains per request | Per minute | Per day | Per month |
|---|---|---|---|---|
| Anonymous No account. Answers from stored data only; a domain we have not measured is not measured, and is not queued. | 1 | 5 | 25 | 300 |
| Free A free Stringer account. May ask us to measure a new domain, up to a daily number. | 10 | 20 | 250 | 5000 |
| Paid An account on a paid plan, or on the Lookup API plan. | 25 | 60 | 2500 | 50000 |
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.