# 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.

- Skill: `hktitan/poke-python` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add hktitan/poke-python`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hktitan/poke-python/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: MIT
- Author: HKTITAN (https://skillmd.com/u/hktitan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hktitan/poke-python

---


# Poke Python SDK — Map of Content

The official Python SDK on PyPI: [`pip install poke`](https://pypi.org/project/poke/). Same surface as the Node SDK ([[../poke/SKILL]]) with Pythonic naming and finer-grained exceptions.

## Setup

- [[references/install]] — `pip install poke`; Python 3.8+; zero dependencies.
- [[references/quickstart]] — `Poke()`, `send_message`, `create_webhook`, `send_webhook` in 10 lines.
- [[references/auth-and-config]] — credential resolution + `base_url`.

## Reliability

- [[references/exceptions]] — `PokeError`, `AuthenticationError`, `ForbiddenError`, `RateLimitError`.

## MCP server-side (Python only — Node SDK has no equivalent)

- [[references/mcp-callbacks]] — `with_callbacks`, `PokeCallbackMiddleware`, callback context for streaming progress to Poke from your MCP tools.

## Cross-references

- The conceptual model is identical to Node — see [[../poke/SKILL]] for SDK methods, [[../poke-webhooks/SKILL]] for webhook design, [[../poke/references/use-cases]] for canonical patterns.
- For tunneling a Python MCP server to Poke, see [[../poke-mcp-tunnel/references/tunnel-local]].

## Reference

- PyPI: https://pypi.org/project/poke/
- API docs: https://poke.com/docs/api