markaDocs
Agent setup

Agent setup

Connect Claude Code, Codex, Cursor or OpenCode to Marka by pasting one sentence into the agent, or follow a guide and do it by hand.

Opens Claude's Add custom connector dialog with Marka's hosted MCP server filled in: click Add, then sign in to Marka. No API key to paste, and the connector syncs to Claude Desktop and the mobile apps.

Or copy the sentence and paste it into your AI coding agent. The agent reads Marka's setup instructions at agent-setup/prompt.md, asks you for an API key once, checks the key, and connects itself to Marka's hosted MCP gateway. It then tells you what it set up and where it stored the key.

The icons open the guide for each agent, if you would rather read the steps first or run them yourself.

What your agent gets

Every Marka action as a tool on the hosted gateway at https://joinmarka.com/api/mcp: search the live catalogue, draft and publish listings, run orders and shipping, manage billing and connected marketplaces. Publishing is publish_listing; it asks your agent to confirm with you first. See Tools for the full list.

By default the gateway lists two tools, search_tools and execute_typescript, instead of one tool per operation. Your agent calls search_tools to see the operations, then runs a short program through execute_typescript that calls them, for example await external_search_listings({ query: "chair" }). If the gateway lists the six operations as tools instead, your agent calls them directly. Either way the operations and their checks are the same.

Before you start: an API key

Create a key at Settings → API keys while signed in. The full mk_… value is shown once, so copy it when it appears.

Your account's email address has to be confirmed first. Until it is, the page shows a notice with a button to resend the confirmation email instead of the create form. Connecting an AI client through your browser asks for the same: the consent page waits for a confirmed email before it offers Allow.

Put the key in the MARKA_API_KEY environment variable of the shell your agent starts from. Every guide below reads it from there, so the key itself never lands in a file you check in. When you use the pasted sentence, the agent asks you for the key if that variable is not set.

Pick your agent

ChatGPT and Cursor

ChatGPT has no install link. In ChatGPT open Settings, Connectors, Advanced and turn Developer mode on. Then create a connector named Marka and paste https://joinmarka.com/api/mcp as the MCP server URL, with OAuth as the authentication.

Cursor has a one-click install link. If you added Marka before November 2026, its entry is named marka: delete the marka key from ~/.cursor/mcp.json before you open the link, so you don't end up with two. Open it and Cursor adds the hosted server:

cursor://anysphere.cursor-deeplink/mcp/install?name=Marka&config=eyJ1cmwiOiJodHRwczovL2pvaW5tYXJrYS5jb20vYXBpL21jcCJ9

Any other MCP client

A client that speaks Streamable HTTP can use the hosted gateway with a config block of this shape. Put it in the client's user-level config, never in a file that is checked in.

{
  "mcpServers": {
    "Marka": {
      "type": "http",
      "url": "https://joinmarka.com/api/mcp",
      "headers": {
        "x-api-key": "${MARKA_API_KEY}"
      }
    }
  }
}

A client that can only start a local process over stdio runs the SDK's bridge instead. It needs Node.js 20.19 or newer and reads the key from MARKA_API_KEY. The bridge proxies the hosted gateway, so it lists the same tools.

npx -y -p @joinmarka/sdk marka-mcp-stdio

Check the key

This call works on every plan. A good key prints a JSON object with your user and plan. A missing, revoked or expired key prints {"error":"unauthorized"} and nothing else.

curl -sS https://joinmarka.com/api/v1/me -H "x-api-key: $MARKA_API_KEY"

For agents

The instructions an agent follows are published as plain Markdown at https://docs.joinmarka.com/agent-setup/prompt.md. They are built from the same data as these pages, so both always give the same commands.

On this page