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
Claude Code
Connect Claude Code to Marka's hosted MCP gateway.
Codex
Connect Codex to Marka's hosted MCP gateway.
Cursor
Connect Cursor to Marka's hosted MCP gateway.
OpenCode
Connect OpenCode to Marka's hosted MCP gateway.
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-stdioCheck 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.
Claude Code
Connect Claude Code to Marka — the hosted gateway over OAuth, an API key for headless use, or the SDK's stdio bridge.
Claude Code
Connect Claude Code to Marka's MCP server with one claude mcp add command for https://joinmarka.com/api/mcp. Your API key stays private to you and this project.