DevelopersOAuth · MCP

Connect your workflows to Cormak

Generate product content through the Store API. Connect your AI tools to tasks, projects, agents and creative workflows through MCP.

Download OpenAPI 3.1

Start with a free discovery request. Choose the permissions and credit limits your integration needs.

Your first successful request

Discover the OAuth resource without an account or token. This request returns HTTP 200 and does not spend credits.

curl --fail https://mcp.cormak.app/.well-known/oauth-protected-resource/mcp

The response identifies https://mcp.cormak.app/mcp and lists supported permissions.

Authentication and access

Register an OAuth public client, use PKCE with SHA-256, and let the account owner review permissions in Cormak. Use the resulting bearer access token. Tokens last up to one hour; refresh tokens rotate and must be refreshed one at a time.

Request store:use for Store API requests, or account:read projects:read for the MCP reading examples. The owner can revoke access and change connection limits in Connections.

Personal API keys are not currently issued. The Postman variable apiKey holds your local OAuth access token; keep its shared value empty.

Use a server integration or the Postman desktop agent. Store API browser preflight is not supported.

Store API v1 reference

Send JSON to POST https://mcp.cormak.app/store with a bearer token. Choose an action in the body.

Implemented Store API actions
ActionResultCredits
accountYour balance, prices and connection limitsFree
fill_textProduct descriptions and selected listing fields1 AI credit
image_startStart one product photoCurrent model and quality quote
image_statusStatus and temporary download links for up to 8 requestsNo new generation

Download the complete API reference for schemas, examples and errors. Store v1 uses the existing action-based endpoint.

Follow the product description and photo tutorial to see how prices, generation and status checks fit together.

MCP integration

Connect a remote HTTP MCP client to https://mcp.cormak.app/mcp. Authenticate with OAuth, initialize, then use tools/list to see tools allowed by your token and connection.

Capabilities include tasks, saved projects, agents, Telegram bot management, AI employee drafts, photo, video and 3D workflows, voiceover, SEO and domain management. AI website and business-plan generation, general CRM access and registrar purchases are outside this public interface.

Start with get_account or list_projects. The MCP integration guide explains setup and polling; the tool reference lists inputs and restrictions. Live tool discovery is authoritative.

Rate limits and credit controls

MCP and Store each allow 120 requests per minute per connection. A separate owner-selected generation limit applies over a rolling 24 hours. Plans, credit balance, AI consent and abuse checks also apply.

Buy AI credits in your Cormak account. Your integration uses the same balance as the app. Video uses separate credit packs; current prices are shown in Billing.

Store generation requests can charge immediately. Read current prices first and send the expected image price. MCP operations use owner confirmation; product workflows can also use an owner-configured delegated credit budget.

Reuse the exact request UUID and parameters on retries. Poll the existing operation; investigate unknown outcomes before another generation. Image download links expire after one hour.

Try the Postman collection

Import the collection and empty environment template, then run Discovery. Paid generations and OAuth setup requests are blocked by default and require deliberate local opt-in.

Keep credentials in your private local environment. Review saved responses before sharing a collection.