# Abyssale — how to use (mcp.ai)

Connect your Abyssale account and use 4 tools for images and design straight from your AI agent. Connect with your own API key. Abyssale is a creative automation platform that enables users to generate images, videos, GIFs, PDFs, and HTML5 content programmatically, streamlining visual content production.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/abyssale/authentication/test` — Tool to test API authentication via the /ready endpoint. Use after configuring your API key to ensure credentials are valid before other requests.
- `POST https://api.mcp.ai/api/abyssale/create/project` — Tool to create a new project to organize designs and images. Use after deciding on a project name to group your templates and assets.
  - body: { name: string }
- `POST https://api.mcp.ai/api/abyssale/get/designs` — Tool to retrieve all designs with optional filtering by category or type. Use after authenticating to list available templates.
  - body: { type?: string, category_id?: string }
- `POST https://api.mcp.ai/api/abyssale/get/fonts` — Tool to list all available fonts, including custom and Google fonts. Use when you need to fetch font options before generating or editing designs.

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

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