poke
Poke SDK & API — Map of Content
Poke is a personal AI agent by Interaction Company. The poke npm package and REST API let you send the agent messages and create webhook triggers programmatically.
This skill is structured as a graph: scan the descriptions below, follow only the [[wikilinks]] you need. Don't read every node up front.
Platform context
- [[references/overview]] — what Poke is, channels (iMessage / Telegram / SMS), languages, status.
- [[references/kitchen]] — the developer dashboard at poke.com/kitchen.
- [[references/use-cases]] — canonical API patterns: desktop capture, event automation, service bridging.
Setup
- [[references/installation]] — installing the npm package, Node version requirements.
- [[references/api-keys]] — getting a V2 key, the V1 vs V2 trap.
- [[references/credential-resolution]] — order in which
Poke()finds an API key.
SDK methods (one node per method)
More from hktitan/poke-skills
poke-python
Build with the Poke Python SDK — `pip install poke`. Mirrors the Node SDK with snake_case methods (`send_message`, `create_webhook`, `send_webhook`), richer exception types, and an MCP callbacks middleware for async tool progress updates. Use when the user is on Python (3.8+), writing a FastAPI/Flask/Django app, or building an MCP server in Python that needs Poke callbacks.
5poke-recipes
Build and publish Poke Recipes — shareable install bundles that combine onboarding context, a first message, required integrations, and a `poke.com/r/<code>` install link. Use when the user asks to "make a Poke recipe", "share my Poke setup", "create an install link", "publish to poke.com/recipes", or wants to monetize a Poke workflow via payouts.
5poke-webhooks
Design and wire up Poke webhook triggers — translate an event source (deploy fail, new signup, alert) into a `createWebhook` + `sendWebhook` pair with a sensible condition/action and a safe payload shape. Use when the user asks to "trigger Poke when X happens", "notify Poke from my app", "build a Poke webhook", or wires Poke into CI/cron/serverless events.
5poke-mcp-tunnel
Connect a local MCP server to a Poke agent using the `poke` CLI — `poke login`, `poke mcp add` for remote URLs, and `poke tunnel` to forward a local port to Poke for development. Use when the user wants to "expose my MCP server to Poke", "test my MCP locally with Poke", "connect Poke to my localhost", or registers a remote MCP URL.
5poke-integrations
Connect tools and services to a user's Poke — built-in integrations (Linear, Notion, GitHub, Sentry, Vercel, Gmail, Outlook, etc.) and custom MCP servers via poke.com/integrations/new. Use when the user asks to "connect X to Poke", "add a custom MCP integration", "list available Poke integrations", "disconnect a service", or builds a recipe that requires specific integrations.
5