PincerAPI Documentation

Everything you need to connect your AI agent to the world.

🚀 Getting Started🎛️ Mission Control📖 Cookbooks🔌 APIs💳 Pricing📡 Agent Connection📊 Widget Data API

🚀Getting Started

  1. 1Create a free account at pincerapi.com/register
  2. 2Subscribe to Pincer ($30/mo) for full access to all cookbooks and the API proxy — or stay on the free plan to try Hatch Your Agent and Dashboard Sync first.
  3. 3Grab your API key from Settings → Pincer API Keys
  4. 4Install OpenClaw on your machine — docs.openclaw.ai
  5. 5

    Tell your agent to install the Pincer skill:

    Install the Pincer skill. My API key is pincer_sk_... and the base URL is https://www.pincerapi.com
  6. 6Run the “Hatch Your Agent” cookbook — it auto-configures everything, creates your first widget, and sets up your dashboard.
  7. 7Your Mission Control dashboard lights up with real-time data! 🦞

🎛️Mission Control

Mission Control is your agent's live dashboard. Every cookbook installs a widget — and widgets update in real-time as your agent pushes new data.

▸The All tab gives you a full overview of every widget at once
▸Each cookbook gets its own tab for a focused view
▸Real-time updates via Server-Sent Events (SSE) — no polling, no lag
▸Chat with your agent directly from the dashboard (Pincer subscribers)

Widget Types

◆Stat rows
◆Lists
◆Charts
◆Text blocks
◆Action buttons

Push data to a widget

POST /api/v1/dashboard/widgets/data
Authorization: Bearer pincer_sk_...
{ "widgetId": "xxx", "data": { "key": "value" } }

Read current widget data

GET /api/v1/dashboard/widgets/data?widgetId=xxx

See the Widget Data API section below for full details on pushing, reading, and trending data.

📖Cookbooks

Cookbooks are step-by-step automations that your agent executes. Think of them as recipes: the agent reads the instructions and carries them out — no manual configuration required.

What each cookbook does

  1. Checks prerequisites (APIs, credentials, permissions)
  2. Walks through interactive Q&A to configure settings
  3. Creates a widget on your Mission Control dashboard
  4. Fetches initial data to populate the widget
  5. Sets up a cron job for recurring execution

🆓 Free Cookbooks

  • ✓Hatch Your Agent — onboarding & setup
  • ✓Dashboard Sync — keep widgets up to date

⭐ Premium Cookbooks

  • ▸SDR Pipeline
  • ▸Fitness Dashboard
  • ▸GitHub Pulse
  • ▸Inbox Zero
  • ▸Calendar Optimizer
  • ▸Market Snapshot
  • ▸Weather & Commute
  • ▸Daily Briefing

Browse all cookbooks at /cookbooks.

🔌APIs

Browse 1,000+ APIs your agent can connect to — all in one directory with per-API instructions your agent can read and execute.

Free proxy — public APIs (unlimited)

No-auth public APIs are proxied through Pincer for free with no call limits. Your agent just calls them — no credentials needed, no setup.

Premium proxy — authenticated APIs (1,000 calls/mo)

Subscribers get 1,000 proxied calls/month for authenticated APIs. Pincer handles the auth layer — your agent doesn't need to manage credentials for supported APIs.

BYOK — Bring Your Own Key

For APIs not covered by the premium proxy, your agent manages its own keys. Pincer provides integration instructions — your agent reads them and configures itself automatically.

Example: call a proxied public API

curl "https://www.pincerapi.com/proxy/wttr.in/New+York?format=j1" \
  -H "Authorization: Bearer pincer_sk_..."

Browse all APIs at /apis.

💳Pricing

Free

Get started, no card required

  • ✓2 cookbooks (Hatch Your Agent + Dashboard Sync)
  • ✓Browse the full API directory
  • ✓Mission Control dashboard (limited)
  • ✗No proxy calls
  • ✗No premium cookbooks
Recommended

Pincer $30/mo

Everything. No surprises.

  • ✓All cookbooks (including premium)
  • ✓1,000 proxy calls/month
  • ✓All widget types + full Mission Control
  • ✓Chat with your agent via dashboard
  • ✓No per-call charges, no deposits
  • ✓Cancel anytime

View full pricing details →

📡Agent Connection

Your agent connects to Pincer via Server-Sent Events (SSE) for real-time two-way communication. The Pincer skill (installed via OpenClaw) handles this automatically.

Pincer → Agent

  • • Skill install instructions
  • • Chat messages from you
  • • Config updates
  • • Cookbook triggers

Agent → Pincer

  • • Widget data syncs
  • • Automation results
  • • Chat replies
  • • Status heartbeats

The connection stays alive with automatic reconnect. If your agent goes offline, it picks back up seamlessly when it comes back online.

Connect your agent (handled automatically by the Pincer skill)

GET https://www.pincerapi.com/api/v1/sse
Authorization: Bearer pincer_sk_...

# Manual test:
curl -N https://www.pincerapi.com/api/v1/sse \
  -H "Authorization: Bearer pincer_sk_..."

Need help setting up OpenClaw? docs.openclaw.ai →

📊Widget Data API

Agents push data to widgets via a simple REST API. Widget templates use {{path.key}} placeholders — the keys in your data payload must match the keys in the widget config.

Push data to a widget

POST /api/v1/dashboard/widgets/data
Authorization: Bearer pincer_sk_...
Content-Type: application/json

{
  "widgetId": "widget_abc123",
  "data": {
    "leads": 42,
    "revenue": 18500,
    "topDeal": "Acme Corp"
  }
}

Read current widget data

GET /api/v1/dashboard/widgets/data?widgetId=widget_abc123
Authorization: Bearer pincer_sk_...

Read historical data (for trend charts)

GET /api/v1/dashboard/widgets/data?widgetId=widget_abc123&history=true&limit=30
Authorization: Bearer pincer_sk_...
▸Template keys like {{leads}} must match data payload keys exactly
▸The API returns warnings for any template keys missing from the payload
▸Each push is stored as a history entry — use ?history=true to retrieve the time series for charts
▸The limit param controls how many historical entries to return (default 30)

📡 Docs API — for your agent

  • GET /api/v1/docsList all doc sections (free)
  • GET /api/v1/docs/{slug}Full content of a section (free)
  • GET /api/v1/docs/search?q=proxySearch docs (free)
Questions? support@pincerapi.com