Overview — MCP server

Abyssale's MCP server lets an AI assistant act on your Abyssale workspace directly from a conversation: browse your designs and projects, look up fonts and credits, generate banners, videos and PDFs, and import new designs from JSON, without you writing any code against the REST API yourself. It speaks the standard MCP protocol.

Claude Code CLI and Claude.ai, for now

Claude Code CLI and Claude.ai are registered clients today. Other MCP clients (Cursor, Claude Desktop, and so on) aren't registered yet — this page will list each one's setup as it's added.

Connect

Property	Detail
Endpoint	https://mcp.abyssale.com/mcp
Transport	Streamable HTTP
Method	POST only
Sessions	None — stateless, so nothing to reconnect or expire
Auth	OAuth (Auth0) — see Authentication

Point an MCP client at the endpoint above — but every client still needs its own registered client id to complete the OAuth login, and Abyssale registers each client separately before it can connect.

Claude Code CLI

Claude Code CLI

claude mcp add --transport http --client-id tpc_iJ7LWqVdzR7c7jf21gMqDQ --callback-port 3418 \
  -s user abyssale_prod https://mcp.abyssale.com/mcp

--client-id and --callback-port are required

Both flags are required for Claude Code CLI, exactly as shown — the OAuth login fails without them. The client id above (tpc_iJ7LWqVdzR7c7jf21gMqDQ) is registered specifically for Claude Code CLI and won't work for another client.

Claude.ai

1. In Claude.ai, go to Settings → Connectors → Add custom connector.
2. Set Name to Abyssale and Remote MCP server URL to https://mcp.abyssale.com/mcp, then click Continue.

3. Under OAuth client, select Use your own OAuth client and enter tpc_j2jnfXMh54sdoP7qu4ziEJ as the client ID — leave the secret blank.

4. Click Add, then complete the login and consent step that follows.

Uploading local files when creating a design

import_design_from_json's local-file upload path needs Claude.ai's sandbox to reach Abyssale's upload bucket. A Claude.ai workspace admin has to add it to the domain allowlist first:

1. Go to claude.ai/admin-settings/capabilities.
2. Under Domain allowlist → Additional allowed domains, add https://production-templates-imports.s3.eu-west-1.amazonaws.com and click Add.

Skip this if you always supply an already-hosted URL or inline base64 image data instead — only the bare-filename upload path needs it.

This client id is specific to Claude.ai

The id above (tpc_j2jnfXMh54sdoP7qu4ziEJ) is registered specifically for Claude.ai and won't work for Claude Code CLI, which uses its own id (see above).

The first tool call — or, for clients that support it, the connection itself — triggers a login and consent step in your browser. See Authentication for what that requires and what it grants.

Where to go next

• Authentication — how you sign in, and what each permission scope unlocks.
• Tools reference — every tool, its parameters, and an example call.
• Permissions — what each tool can actually do, and what to check before you authorize it.

Support

Something not working, or a question the docs don't answer? Reach the Abyssale team through the help center.