Documentation
What is WhipNode?
WhipNode is a context relay for AI agents. Upload a screenshot, file, or document at whipnode.com, and your AI tool can read it instantly — with OCR text extraction, structured outputs, and your notes attached. You can also give your agent a URL and WhipNode will screenshot it for you.
Getting Started
Step 1 — Create an account
Sign in with your email. No password needed — we send you a magic link.
Step 2 — Create an API key
Go to the API Keys tab in your dashboard and create a key. Save it — it's only shown once.
Step 3 — Connect Claude Code
Run this in your terminal:
claude mcp add whipnode --transport http https://whipnode.com/api/v1/mcp --header "X-API-Key: YOUR_API_KEY"That's it. Your API key is used once to register the device. After that, WhipNode assigns a secure session token automatically — the key never needs to be sent again.
For Codex CLI and other tools, see the setup instructions in your dashboard.
Step 4 — Upload and share
Upload a screenshot or file at whipnode.com/new. Paste the URL into your AI session. Your agent reads it automatically.
How It Works
1. You upload
Paste a screenshot, drag a file, or upload via the API. Add an optional note describing what you need.
2. WhipNode processes
Images are scanned with OCR to extract text. Every upload is converted into five formats — JSON, Markdown, YAML, plain text, and a prompt pack optimized for AI agents. Files are hashed with SHA-256 for integrity.
3. Your agent reads
If you connected Claude Code via MCP, it can read WhipNode content natively using the whipnode_fetch tool. For other tools, paste the URL — the agent fetches it directly.
MCP Tools
When connected via MCP, your AI tool gets five tools automatically:
| Tool | What it does |
|---|---|
whipnode_fetch | Read any WhipNode item — OCR text, files, notes |
whipnode_upload | Upload a file and get a shareable URL |
whipnode_capture | Screenshot a live URL at any viewport (desktop, mobile, tablet, etc.) |
whipnode_render | Render HTML at multiple viewports — responsive design comparison |
whipnode_list | List your recent uploads |
URL Capture
Give WhipNode a URL and it takes a screenshot using a headless browser on Cloudflare's edge network. The screenshot is processed with OCR and converted to all five output formats — just like a file upload.
Viewport presets: desktop (1280x800), laptop (1024x768), tablet (768x1024), mobile (375x812), 1080p, and 4K. Full-page capture optional.
Use cases: sharing staging sites with your agent, checking what a live page looks like, capturing error pages for debugging.
Responsive Rendering
Upload HTML or provide a preview item, and WhipNode renders it at multiple viewports simultaneously. See how your page looks on desktop, tablet, and mobile side by side.
The share page shows a gallery view with viewport tabs, device icons, resolution labels, and download buttons per viewport.
Security
Device-based authentication
When you connect Claude Code (or any MCP client), your API key is used once to register the device. WhipNode assigns a secure session token (Mcp-Session-Id) that the client stores and uses for all future requests. The API key is never sent again.
You can see all connected devices in the Devices tab of your dashboard. Revoke any device instantly — the next request from that device will fail and need to re-authenticate.
Key rotation
Rotate an API key from the dashboard. A new key is generated, and your old key continues working for 15 minutes (grace period) while you update your agents. No downtime.
Data handling
- All uploads expire after 24 hours and are permanently deleted
- Files are hashed with SHA-256 for integrity verification
- API keys are stored as SHA-256 hashes — raw keys never stored
- Session tokens hashed at rest, 90-day expiry
- Output renderers include safety preambles warning agents to treat user content as untrusted
- Prompt injection scanner detects 13 common attack patterns
Output Formats
Every upload generates five formats, each at its own URL:
| Format | URL Pattern | Best for |
|---|---|---|
| JSON | /api/v1/items/:id | Programmatic access, full metadata |
| Markdown | /api/v1/items/:id.md | Human reading, LLM-friendly |
| YAML | /api/v1/items/:id.yaml | Automation, config-style output |
| Plain Text | /api/v1/items/:id.txt | Universal fallback |
| Prompt Pack | /api/v1/items/:id/prompt.md | AI agents — includes context, task, and file data |
Further Reading
- API Reference — all endpoints, request/response formats
- Integration Examples — curl, Claude Code, Codex workflows
- FAQ — common questions