AgentReady API Docs

Introduction

AgentReady provides 7 API tools to optimize any website for AI consumption. Whether you're building an AI agent, an SEO tool, or a SaaS that interacts with LLMs, these endpoints help you reduce token costs, extract clean content, audit AI readiness, and more.

  • TokenCut
  • MD Converter
  • Sitemap Gen
  • LLMO Auditor
  • Struct. Data
  • Robots.txt
  • Image Proxy

Authentication

All API requests require an API key passed as a Bearer token in the Authorization header.

curl -X POST https://agentready.cloud/api/v1/tools/tokencut \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world", "level": "standard"}'

Create API keys in your Dashboard → API Keys. Keys start with ak_.

Base URL

https://agentready.cloud

Tools API: /api/v1/

Two-Step Compress (Recommended)

The fastest way to integrate AgentReady. Compress your messages through our API, then call OpenAI directly with the compressed result. Your LLM key never touches AgentReady servers.

import agentready
from openai import OpenAI
import os

# Step 1 — compress via AgentReady
result = agentready.compress(
    api_key=os.environ["AGENTREADY_API_KEY"],
    messages=[{"role": "user", "content": "..."}]
)

# Step 2 — call OpenAI directly
client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])
response = client.chat.completions.create(
    model="gpt-4o",
    messages=result["messages"]
)

✅ Full OpenAI compatibility

✅ Works with any SDK

🔒 Zero key exposure

Quick Start

Get started in 3 steps:

  1. Sign up & create an API key

  2. Make your first API call

  3. Integrate into your pipeline

Tools API — 7 Endpoints

TokenCut — Cut LLM Costs by 40-60%

/api/v1/tools/tokencut
```1 credit

#### MD Converter — URL to Clean Markdown

```POST
/api/v1/tools/md-converter
```1 credit

#### Sitemap Generator — Crawl & Map Websites

```POST
/api/v1/tools/sitemap-generator
```5-100 credits

#### LLMO Auditor — AI Readiness Audit

```POST
/api/v1/tools/llmo-auditor
```2 credits

#### Structured Data Analyzer

```POST
/api/v1/tools/structured-data
```1 credit

#### Robots.txt Analyzer

```POST
/api/v1/tools/robots-txt
```1 credit

#### Image Proxy — Resize & Analyze Images

```POST
/api/v1/tools/image-proxy
```1-3 credits

## Integrate into Your SaaS

Here's how to use each AgentReady tool in your application. Copy the Python or JavaScript wrapper functions below.

## Common SaaS Use Cases

### RAG Pipeline

Use MD Converter + Sitemap to crawl sites → clean Markdown → feed into vector DB → query with LLM. Pipe through TokenCut first to save 40-60%.

### SEO / LLMO SaaS

Build an SEO tool that audits any URL for AI readiness. Use LLMO Auditor + Structured Data + Robots.txt for a full report.

### Content API

Offer a "convert any URL to Markdown" feature in your app. Use MD Converter with TokenCut for optimal output.

### AI Agent Toolkit

Give your AI agent the ability to read any webpage, analyze images, and check site accessibility. All 7 tools as agent functions.

## AI Prompts

Copy these prompts and paste them into **Cursor, GitHub Copilot, ChatGPT, or Claude** to instantly integrate AgentReady into your codebase.

### Integrations

### LangChain

Use AgentReady as a pre-processing step inside any LangChain chain. Compress long documents before sending them to the LLM to cut token costs.

### CrewAI

Add AgentReady as a custom tool in your CrewAI agent crew. Agents can call TokenCut autonomously to compress context before reasoning.

### OpenAI SDK (Python)

The simplest integration: compress your prompt text before calling the OpenAI SDK. Works identically with Anthropic, Mistral, or any other provider.

### MCP Server (Model Context Protocol)

Expose AgentReady tools as an MCP server so any MCP-compatible client (Cursor, Windsurf, Claude Desktop) can use them natively.

### cURL / Shell Scripts

Quick terminal one-liners for testing or scripting. Pipe output directly into other tools.

## Account API

### Credits & Billing

### API Keys

## Reference

### Error Handling

### Credit Costs

| Tool | Credits |
| --- | --- |
| TokenCut | 1 credit per compression |
| MD Converter | 1 credit per URL |
| Sitemap Generator | 5 / 20 / 50 / 100 (based on max_pages) |
| LLMO Auditor | 2 credits per audit |
| Structured Data | 1 credit per analysis |
| Robots.txt Analyzer | 1 credit per analysis |
| Image Proxy | 1 credit |

### Rate Limits