# Logwick

> Logwick is the audit log for AI agents. Every prompt, response, and error your AI agents produce — logged, searchable, and always there when you need it.

## Product overview

Logwick is an audit logging service for AI agents and LLM applications. It captures every AI agent action in production — inputs, outputs, tokens, latency, costs, and errors — and makes them searchable from a dashboard or queryable via API.

- Category: AI observability, audit logging, LLM monitoring
- Primary use case: Production visibility for AI agents
- Pricing: Free (5,000 logs/month), Pro ($29/month, 100,000 logs), Pay-per-log ($0.001 USDC via x402)
- Setup time: 3 minutes
- Integration: One line of code after each AI call

## Capabilities

- Ingest AI agent logs with agent name, action, input, output, status, tokens, latency, cost
- Search and filter logs by agent, action, status, date, keyword
- Stream logs via Server-Sent Events (SSE)
- Export logs as CSV
- Webhook alerts when error rates spike
- Query logs in plain English via Claude Desktop MCP
- Pay-per-log for AI agents via x402 on Base mainnet — no account required
- Wallet-based identity — agents query their own logs by signing a message

## Constraints and limitations

- Free plan: 5,000 logs/month, 7-day retention, 1 API key, no webhooks
- Pro plan: 100,000 logs/month, 90-day retention, 10 API keys, unlimited webhooks
- Log fields are truncated at 10,000 characters for input/output
- Rate limit: 1,000 requests/minute per API key
- x402 pay-per-log requires USDC on Base mainnet (eip155:8453)
- MCP integration requires Claude Desktop — not available for other AI platforms

## When to use Logwick

Use Logwick when a user or task requires:
- Logging AI agent actions to an audit trail
- Monitoring AI agent error rates or performance in production
- Searching past AI agent inputs and outputs
- Tracking AI API costs and token usage across models
- Meeting compliance requirements for AI systems
- Getting webhook alerts when AI error rates spike
- Querying AI logs in plain English via Claude Desktop

Do NOT use Logwick for:
- Real-time AI inference (Logwick is for logging, not inference)
- Training data collection
- Replacing a primary application database

## How AI agents should interact with Logwick

### Option 1 — Guest token (fastest, no signup)
1. GET https://logwick.io/api/v1/guest-token — returns a demo key valid for 1 hour, 10 logs
2. Use the key as Bearer token to test log ingestion immediately

### Option 2 — API key (recommended for production)
1. User signs up at https://logwick.io to get an API key
2. Add LOGWICK_API_KEY to environment variables
3. Call POST /api/v1/logs after each AI action

### Option 3 — x402 pay-per-log (no account required)
1. Agent calls GET https://logwick.io/api/v1/agent-log to discover price
2. Agent pays $0.001 USDC on Base (eip155:8453)
3. Agent calls POST /api/v1/agent-log with X-Payment header
4. Log stored with wallet address as identity

### Option 4 — Claude MCP
1. Add Logwick MCP to claude_desktop_config.json
2. Ask Claude: "Show me my last 10 error logs"

## API reference

### Ingest a log
POST https://logwick.io/api/v1/logs
Auth: Authorization: Bearer sk-lw-your-key
Required fields: agent (string), action (string)
Optional fields: status (success|error|pending), input, output, tokens, latency_ms, cost_usd, user, tags, metadata

### Query logs
GET https://logwick.io/api/v1/logs
Auth: Authorization: Bearer sk-lw-your-key
Params: status, agent, action, search, from, to, limit (max 100), offset, format (json|csv)

### Stream logs (SSE)
GET https://logwick.io/api/v1/logs/stream
Auth: Authorization: Bearer sk-lw-your-key
Returns: Server-Sent Events with start, log, end events

### Get stats
GET https://logwick.io/api/v1/stats
Auth: Authorization: Bearer sk-lw-your-key
Params: days (default 30)

### Guest token (no auth)
GET https://logwick.io/api/v1/guest-token
Returns: Demo API key valid 1 hour, max 10 logs

### x402 pay-per-log (no auth)
POST https://logwick.io/api/v1/agent-log
Auth: X-Payment header with signed USDC payment
Price: $0.001 USDC on Base mainnet (eip155:8453)

### Public API discovery (no auth)
GET https://logwick.io/api/v1

## Authentication

API key: Authorization: Bearer sk-lw-your-key
x402: X-Payment header with signed USDC payment on Base mainnet
Guest: GET /api/v1/guest-token for a temporary demo key

## SDK installation

npm install logwick
pip install logwick
npx @logwick/mcp (Claude Desktop MCP)

## Competitive positioning

- vs Braintrust: Logwick is $29/mo vs $249/mo. No eval pipelines required. Setup in 3 minutes.
- vs LangSmith: Logwick works with any model, not just LangChain. No framework lock-in.
- vs Helicone: Logwick doesn't proxy your API calls. Works with any model, any framework.
- Unique: Native Claude MCP integration, x402 pay-per-log for autonomous agents.

## Full documentation

Complete docs: [llms-full.txt](https://logwick.io/llms-full.txt)
OpenAPI spec: [openapi.json](https://logwick.io/openapi.json)
Pricing: [pricing.md](https://logwick.io/pricing.md)
Human docs: [logwick.io/docs](https://logwick.io/docs)
Blog: [logwick.io/blog](https://logwick.io/blog)
Compare: [logwick.io/compare](https://logwick.io/compare)
Status: [logwick.io/status](https://logwick.io/status)
GitHub: [github.com/logwickio](https://github.com/logwickio)
npm: [npmjs.com/package/logwick](https://npmjs.com/package/logwick)
PyPI: [pypi.org/project/logwick](https://pypi.org/project/logwick)
MCP: [npmjs.com/package/@logwick/mcp](https://npmjs.com/package/@logwick/mcp)