# Handwrite.io — how to use (mcp.ai)

Connect your Handwrite.io account and use 4 tools for customer appreciation straight from your AI agent. Connect with your own API key. Handwrite.io creates and tracks physical handwritten card orders using selectable handwriting and stationery styles.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_handwrite?ms=1787293680000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `handwrite_get_order`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/handwrite`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/handwrite/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/handwrite/get/order` — Get a Handwrite order by ID, including its current status, test or live environment, addresses, and proof images when available.
  - body: { order_id: string }
- `POST https://api.mcp.ai/api/handwrite/list/handwriting/styles` — List the handwriting styles available to the connected Handwrite account, including the style ID required when sending cards and a preview URL.
- `POST https://api.mcp.ai/api/handwrite/list/stationery` — List public stationery and custom stationery available to the connected Handwrite account, including the card ID required when sending cards and a preview URL.
- `POST https://api.mcp.ai/api/handwrite/send/cards` — Create handwritten-card orders for one or more recipients. With a test API key, this creates persistent non-production records and sends no physical cards; with a live API key, it creates billable phy
  - body: { send_requests: object[] }

## Example prompts
- "What can I do in Handwrite.io?"
- "Show me a summary of my Handwrite.io account"

## More
- Page: https://mcp.ai/handwrite
- Agent spec (llms.txt): https://mcp.ai/handwrite/llms.txt
- Postman collection: https://mcp.ai/handwrite/postman.json