# HyPeMa

> HyPeMa is an AI-powered SaaS platform for hyper-personalized cold email outreach. It researches leads, writes unique emails for each recipient, and creates Gmail drafts via a Chrome extension. It also provides a remote MCP server for direct AI assistant integration.

## About

HyPeMa (Hyper Personalized Mail) helps founders, sales teams, and BD managers send cold emails that actually get replies. Instead of templates, AI researches each lead's company and writes a unique, personalized email. Emails are delivered as Gmail drafts — users review and send from their real inbox. No spam infrastructure, no warmup needed.

## How It Works

1. **Find Leads** — AI searches the web for real people matching your criteria (industry, role, region), or import from CSV
2. **Draft Emails** — Describe your pitch; AI writes a personalized email for every lead using real company research
3. **Review & Send** — Chrome extension creates Gmail drafts. Review, tweak, and send from your real Gmail account

## Key Features

- AI-powered lead generation with web research
- Hyper-personalized email generation (not templates)
- Chrome extension for Gmail draft creation
- Token-based billing (pay for what you use)
- CSV import for existing contacts
- Unsubscribe management
- REST API for integrations
- MCP server for AI assistant integration (Claude, ChatGPT, Cursor, VS Code, etc.)

## MCP Server

HyPeMa provides a remote MCP (Model Context Protocol) server that lets AI assistants use HyPeMa directly. One server, every platform.

- **Server URL:** `https://mcp.hypema.app/mcp`
- **Transport:** Streamable HTTP
- **Auth:** OAuth 2.1 (Claude.ai, ChatGPT) or API key (Cursor, VS Code, CLI)

### MCP Tools (10 total)

| Tool | Description | Type |
|------|-------------|------|
| `research_company` | Research a company by URL using AI web search | AI-powered, read-only |
| `generate_leads` | Find prospect leads matching criteria (industry, role, region) | AI-powered |
| `list_leads` | List leads with filtering, search, and pagination | Read-only |
| `get_lead` | Get full details of a specific lead | Read-only |
| `create_lead` | Create a new lead manually | CRUD |
| `update_lead` | Update an existing lead's information | CRUD |
| `delete_lead` | Permanently delete a lead | Destructive |
| `generate_email` | Generate a personalized cold email for a lead | AI-powered |
| `generate_email_batch` | Generate emails for all leads in a group | AI-powered |
| `check_usage` | Check token balance and usage | Read-only |

### Connecting to HyPeMa via MCP

**Claude.ai:** Settings → Connectors → Add custom connector → `https://mcp.hypema.app/mcp`
**ChatGPT:** Settings → Apps & Connectors → Add → `https://mcp.hypema.app/mcp` (requires Developer Mode)
**Claude Code:** `claude mcp add hypema --transport http https://mcp.hypema.app/mcp`
**Cursor/VS Code:** Add to MCP config with `Authorization: Bearer hpm_live_...` header

## REST API

Base URL: `https://hypema.app/api/v1`

Authentication via API key (`Authorization: Bearer hpm_live_...`) or Supabase OAuth JWT.

### Endpoints

- `POST /ai/research-company` — AI-powered company research (~25-40 tokens)
- `POST /ai/generate-leads` — AI lead generation (~30-60 tokens)
- `POST /emails/generate` — Generate personalized email (~15-25 tokens)
- `POST /emails/generate-batch` — Batch email generation
- `GET /emails/:id` — Get generated email
- `POST /emails/:id/build-draft-payload` — Build Gmail draft payload
- `GET /leads` — List leads (filterable, paginated)
- `POST /leads` — Create lead
- `GET /leads/:id` — Get lead details
- `PATCH /leads/:id` — Update lead
- `DELETE /leads/:id` — Delete lead
- `GET /lead-groups` — List lead groups
- `POST /lead-groups` — Create lead group
- `GET /lead-groups/:id/leads` — Get leads in group
- `GET /usage` — Check token balance

## Pricing

- **Free:** 500 tokens/month (100 tokens = 1 EUR)
- **Pro:** 4,900 tokens/month at 49 EUR/month

## Docs

- [Landing Page](https://hypema.app): Product overview and pricing
- [Web App Guide](https://hypema.app/docs/guide): How to use HyPeMa — [Markdown version](https://hypema.app/docs/guide.md)
- [MCP Integration Guide](https://hypema.app/docs/mcp): Connect HyPeMa to AI assistants — [Markdown version](https://hypema.app/docs/mcp.md)
- [API Reference](https://hypema.app/docs/api-reference): REST API documentation — [Markdown version](https://hypema.app/docs/api-reference.md)
- [Privacy Policy](https://hypema.app/privacy): How we handle user data
- [Terms of Service](https://hypema.app/terms): Terms governing use of the platform
- [Imprint](https://hypema.app/imprint): Legal company information

For full documentation in machine-readable format, fetch the markdown files directly:
- `https://hypema.app/docs/guide.md`
- `https://hypema.app/docs/mcp.md`
- `https://hypema.app/docs/api-reference.md`

## Tech Stack

- Frontend: React + Vite + Tailwind CSS
- Backend: Node.js / Express (Cloudflare Workers compatible)
- MCP Server: Cloudflare Worker (Streamable HTTP, agents SDK)
- Database: Supabase (PostgreSQL, EU-Frankfurt)
- AI: Anthropic Claude API
- Auth: Google OAuth via Supabase Auth

## Company

HyPeMa is operated by OXO UG (haftungsbeschraenkt), based in Seehausen am Staffelsee, Germany.

## Contact

- Email: service@newstelligent.com
- Website: https://hypema.app