# Zipf AI — Persistent Web Monitoring for AI Agents

Know first. Act first. Search returns answers. Zipf puts agents on patrol.

## What is Zipf?

Zipf is persistent web monitoring built for AI agents and teams. Deploy agents that watch web sources on a schedule, understand what changed, ignore what didn't matter, and deliver signals when something does.

## Core Capabilities

- **Search** — Web search with 1000+ character queries, authority/recency/document-type filters, query decomposition into parallel sub-queries, and semantic reranking.
- **Crawl & Extract** — Agent-driven web crawling with structured JSON extraction, Smart Crawl prioritization (135x discovery efficiency), and intent-driven neural URL scoring.
- **Workflows / Monitors** — Scheduled monitoring with semantic stop conditions, change detection, signal scoring (0-100), and delivery to Slack, email, or webhooks.
- **Sessions** — Multi-step research with automatic URL deduplication across operations and context accumulation.
- **Ask** — Direct answers with source citations in quick (~3s), standard (~10s), and deep modes.

## Getting Started

1. **Sign up** at [https://zipf.ai/pricing](https://zipf.ai/pricing) (Free tier: 100 credits/month)
2. **Create an API token** at [https://zipf.ai/dashboard/tokens](https://zipf.ai/dashboard/tokens)
3. **Make your first search:**

```bash
curl -X POST https://api.zipf.ai/v1/searches \
  -H "Authorization: Bearer $ZIPF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "AI infrastructure startups", "max_results": 10}'
```

## For AI Agents (MCP)

Zipf provides an MCP server for direct agent integration:

- **Server URL:** https://api.zipf.ai/mcp
- **Transport:** Streamable HTTP
- **Authentication:** OAuth 2.0 (with Bearer token fallback)

```bash
npx @anthropic-ai/claude-code mcp add zipf-ai https://api.zipf.ai/mcp
```

## Resources

| Resource | URL |
|----------|-----|
| API Documentation | [https://zipf.ai/docs](https://zipf.ai/docs) |
| OpenAPI Spec | [https://zipf.ai/openapi.json](https://zipf.ai/openapi.json) |
| LLM Reference | [https://zipf.ai/llms.txt](https://zipf.ai/llms.txt) |
| Full LLM Reference | [https://zipf.ai/llms-full.txt](https://zipf.ai/llms-full.txt) |
| Agent Guide | [https://zipf.ai/agents.md](https://zipf.ai/agents.md) |
| Pricing | [https://zipf.ai/pricing.md](https://zipf.ai/pricing.md) |
| MCP Discovery | [https://zipf.ai/.well-known/mcp.json](https://zipf.ai/.well-known/mcp.json) |
| Agent Card (A2A) | [https://zipf.ai/.well-known/agent-card.json](https://zipf.ai/.well-known/agent-card.json) |

## Pricing

| Plan | Monthly | Credits |
|------|---------|---------|
| Free | $0 | 100 |
| Developer | $30 | 1,000 |
| Pro | $100 | 5,000 |
| Scale | $500 | 30,000 |

## Contact

- Support: support@zipf.ai
- Documentation: https://zipf.ai/docs