Is Agentic developer docs

Is Agentic is currently free to use. There are no paid plans, subscription charges, or per-report fees. The public website, read-only API, official CLI, and MCP server are available without payment. Read the concise, machine-readable Is Agentic pricing statement.

Retrieve the latest completed Is Agentic report for a public URL. The response includes the score, Essential and Recommended buckets, bonus signals, evidence-backed issues, and the canonical browser report. This read-only endpoint does not launch a scan.

curl "https://is-agentic.com/api/v1/report?url=https%3A%2F%2Fexample.com"

Read the complete request and response schema in the Is Agentic OpenAPI description. Discover the API portfolio through the RFC 9727 API catalog.

Every documented report API error and every scan failure returned before streaming uses RFC 9457 problem details with application/problem+json. Responses include a stable code, human-readable detail, and a concreteresolution hint. Unknown API routes and methods return the same shape instead of an HTML error page.

invalid_url · 400

Pass a public HTTP or HTTPS URL.

report_not_found · 404

Run the linked scan, then retry after completion.

method_not_allowed · 405

Use the documented read-only GET operation.

rate_limit_exceeded · 429

Honor Retry-After before retrying.

report_temporarily_unavailable · 503

Retry shortly without launching a new scan.

api_route_not_found · 404

Use OpenAPI or the API catalog to recover.

The report API allows 120 requests per client IP in each 60-second window. Responses advertise the policy and current quota through the current IETF RateLimit-Policy and RateLimitstructured fields, with compatibility fields for older clients. A 429 response also includes Retry-After.

Stable REST operations use a major version in the URL, beginning with /api/v1. Backward-compatible fields may be added within v1; breaking request or response changes require a new major path. Before removing a stable version, Is Agentic will publish a migration guide and signal deprecation with RFC 9745 Deprecationand Link headers. A dated Sunset header will be announced at least 90 days before removal.

The unversioned /api/report route remains available as a deprecated compatibility alias. No sunset is currently scheduled; new integrations should use /api/v1/report.

Retrieve the latest completed report from a terminal with the official is-agentic package on npm. The command calls the same read-only public API, renders a compact terminal score with every failed or partial finding, and returns a stored report immediately. When no completed report exists, it starts a scan and waits for the stored result. Add --json for the unchanged API response and structured error objects suitable for agents and scripts.

npx is-agentic <domain>
npx is-agentic <domain> --json

Connect a Streamable HTTP MCP client to the endpoint below. The server exposes three read-only tools: is_agentic_get_report for completed reports, is_agentic_get_methodology for score interpretation, and is_agentic_get_developer_docs for integration guidance. Each returns text plus structured data.

https://is-agentic.com/mcp

Clients and registries can discover the remote transport through the Is Agentic MCP Registry manifest. Remote clients can also fetch the MCP server card from the predictable transport-relative server-card endpoint or its well-known compatibility URL. Domain-level discovery starts at the Is Agentic AI Catalog. These documents declare the Streamable HTTP endpoint and require no authentication.

The report tool links to an interactive score card through the MCP Apps ui://is-agentic/score-report.html resource. Hosts that support MCP Apps can render the report directly in conversation; every other host still receives the same text and structured result.

Public content pages and completed scan reports support canonical Accept: text/markdown negotiation. Markdown variants set Content-Type: text/markdown; charset=utf-8 and include Accept in the Vary response header so shared caches never mix representations.

curl -H "Accept: text/markdown" https://is-agentic.com/methodology

The documented JSON API and MCP tool are public and read-only. They require no API key or OAuth flow, expose no credentials, and do not provide writes, webhooks, or event subscriptions. Start a new scan on the Is Agentic home page, then use these interfaces after the report completes.

Because the API exposes one read-only resource and no collection, write, or long-running operation, pagination, Idempotency-Key, and asynchronous-job conventions do not apply. The OpenAPI description is the supported language-neutral integration contract; the official CLI is the maintained command-line client.