# Hyperise — how to use (mcp.ai)

Connect your Hyperise account and use 5 tools for marketing automation straight from your AI agent. Connect with your own API key. Hyperise is a personalization toolkit that enables sales and marketing teams to add dynamic, personalized elements to images, videos, and websites, enhancing engagement across various channels.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hyperise?ms=1787295720000`
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. `hyperise_create_client_account`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hyperise`
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/hyperise/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hyperise/create/client/account` — Creates a new Hyperise business/client account for personalized image campaigns. Use this to provision prospect records that can be linked to Hyperise image templates. The website field is required in
  - body: { name: string, email: string, extras?: object, business_id: string }
- `POST https://api.mcp.ai/api/hyperise/list/image/templates` — Retrieves all active personalized image templates for the authenticated user. Use this tool when you need to: - Get a list of available Hyperise image templates - Find template IDs for use with other 
- `POST https://api.mcp.ai/api/hyperise/personalized/short/links` — Generate a personalized short link with Open Graph metadata for rich link previews. This tool creates a shareable URL that: - Redirects to your destination page - Shows personalized image previews whe
  - body: { url: string, desc: string, title: string, image_hash: string, query_params?: object }
- `POST https://api.mcp.ai/api/hyperise/prospect/business/data` — Tool to perform CRUD operations on Hyperise business prospect records. Use when managing business data via the Hyperise API.
  - body: { id?: integer, lat?: string, logo?: string, long?: string, email?: string, phone?: string, title?: string, gender?: string, website?: string, category?: string, job_title?: string, last_name?: string, operation: string, first_name?: string, business_name?: string, custom_text_1?: string, custom_text_2?: string, custom_text_3?: string, custom_text_4?: string, profile_image?: string, business_phone?: string, custom_image_1?: string, custom_image_2?: string, custom_image_3?: string, business_address?: string }
- `POST https://api.mcp.ai/api/hyperise/user/authentication` — Tool to authenticate an API token and retrieve user details. Use after obtaining a valid API token from Hyperise settings.
  - body: { api_token?: string }

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

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