Connect an AI agent with MCP
Creatimatic exposes tools at https://creatimatic.com/api/mcp through the official TypeScript MCP SDK's stateless Streamable HTTP transport. The server provides request/response tools; it does not maintain chat history or a persistent SSE session. Use the SDK-supported protocol negotiated at initialization (including the 2025-11-25 tool protocol). New protocol revisions require SDK compatibility testing before they are advertised.
Client requirements
Your client must support a remote Streamable HTTP MCP server and a configurable Authorization header. Create a scoped key in Settings → AI agents.
The following is a configuration shape, not a universal file format. Adapt it to your client's documented settings:
{
"url": "https://creatimatic.com/api/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_CREATIMATIC_AGENT_KEY"
}
}Keep the secret in the client's secret store or environment-variable mechanism rather than committing this file. Local setups can substitute http://localhost:3000/api/mcp.
Connect with the official TypeScript SDK
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const key = process.env.CREATIMATIC_AGENT_KEY;
if (!key) throw new Error("Set CREATIMATIC_AGENT_KEY in secret storage");
const client = new Client({ name: "my-pod-agent", version: "1.0.0" });
await client.connect(
new StreamableHTTPClientTransport(
new URL("https://creatimatic.com/api/mcp"),
{ requestInit: { headers: { Authorization: `Bearer ${key}` } } },
),
);
const catalog = await client.listTools();
console.log(catalog.tools.map((tool) => tool.name));
const ideas = await client.callTool({
name: "list_ideas",
arguments: { limit: 10 },
});
await client.close();Available permissions
The MCP tool list includes only tools allowed by the key's scopes. A read-only key cannot discover or invoke write/generation tools. Revocation applies to the next HTTP request. Your seller account is resolved for every executed tool.
For mutations, put idempotencyKey in the MCP tool arguments. The server's tool schema exposes that requirement. Check isError in tool results and never assume an HTTP-successful MCP response means the operation succeeded.
Publishing and compatibility
Call prepare_publish_review to obtain the seller's product editor link. The seller confirms Etsy posting inside Creatimatic. There is no direct MCP publish tool in this release.
OAuth client registration, delegated OAuth consent, local stdio distribution, MCP Apps and native Muse/Dots integrations are not included. An OAuth-only client needs a different connection path; use the HTTP API if it can supply authenticated HTTP tools. See the official MCP SDK documentation for transport details.
Creatimatic Agent API reference
Authenticate an AI agent, discover print-on-demand tools, execute scoped operations and handle retries without duplicating work.
From a design family to a reviewed POD product
An agent workflow for existing design families, shirt-color contrast, verified mockups, accurate listing copy and Etsy review.