Poke MCP Examples

Complete, production-ready examples demonstrating all authentication patterns for building MCP (Model Context Protocol) integrations for Poke.

🚀 Getting Started

# Clone this repository
git clone https://github.com/InteractionCo/poke-mcp-examples.git
cd poke-mcp-examples

# Pick an example and follow its README
cd iss-tracker  # or weather-api, whoop-integration, bookmark-manager

Each example is self-contained with its own dependencies and documentation.

📚 Examples

🎯 Choose Your Path

New to MCP? Start with ISS Tracker - no authentication needed, 5 minutes to deploy.

Learning the basics? Check the Template for basic server patterns and structure.

Building for production? Jump to Bookmark Manager for full OAuth + Dynamic Client Registration.

🏗️ Repository Structure

poke-mcp-examples/
├── iss-tracker/          # No auth example
├── weather-api/          # API key auth example
├── whoop-integration/    # OAuth proxy example
├── bookmark-manager/     # Full OAuth + DCR example
└── mcp-server-template/  # Reference implementation

Each directory contains:

• src/server.py - Server implementation
• requirements.txt - Python dependencies
• .env.example - Environment variables (if needed)
• README.md - Detailed documentation

📖 What These Examples Teach

No Authentication: ISS Tracker

• Building tools for public APIs
• Deploying to Render with HTTPS
• Connecting to Poke without auth
• Rate limiting for public endpoints

API Key: Weather API

• Validating bearer tokens on every request
• Returning proper 401 errors
• Per-API-key rate limiting
• Secure credential handling

OAuth Proxy: WHOOP Integration

• Wrapping existing OAuth providers
• Token forwarding to upstream APIs
• Handling refresh tokens
• Per-user data access

Remote OAuth + DCR: Bookmark Manager

• Building new services from scratch
• Full MCP spec compliance
• JWT validation with JWKS
• Per-user data isolation

🚢 Deployment

All examples can be deployed to Render:

1. Fork this repository on GitHub
2. Create a new Web Service on Render
3. Connect your forked repository
4. Set the Working Directory to the specific example (e.g., iss-tracker)