Free beta. The Marky API is free to use while it’s in beta. Paid plans are
coming later, and we’ll give you plenty of notice before any charges begin.
CLAUDE.md instead.
The MCP setup works for both the Claude Code CLI and the Claude Desktop
app (this is the same app used for Cowork). Pick your tool in the tabs below.
Get your API key
Open app.mymarky.ai/connect-claude — sign up
or log in and your mk_live_... key is created in one click (copy it right away; you
only see it once). No workspace setup needed first.
Prefer the manual route? Settings → API Keys
→ Create API Key while signed in — that’s also where you revoke keys.
Option A: MCP server (recommended)
Marky’s MCP server lives at one URL, and you sign in with your API key:
URL: https://api.mymarky.ai/api/mcp
Auth: Authorization: Bearer mk_live_YOUR_KEY
Claude Code CLI
Claude Desktop app
Add Marky as an MCP server in one command. Replace mk_live_YOUR_KEY with
the key you just created:claude mcp add --transport http marky https://api.mymarky.ai/api/mcp \
--header "Authorization: Bearer mk_live_YOUR_KEY"
The Claude Desktop app (the same app used for Cowork) reads its servers from
a file called claude_desktop_config.json. You add Marky there.1. Open the config file. In the Claude Desktop app, go to
Settings → Developer → Edit Config. That opens (or creates)
claude_desktop_config.json. You can also open it by hand:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
2. Add Marky to the file. Paste the block below. If the file already has
an mcpServers section, just add the marky part inside it. Replace
mk_live_YOUR_KEY with your key:{
"mcpServers": {
"marky": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.mymarky.ai/api/mcp",
"--header",
"Authorization:${MARKY_AUTH}"
],
"env": {
"MARKY_AUTH": "Bearer mk_live_YOUR_KEY"
}
}
}
}
The Claude Desktop app connects to MCP servers that run on your computer.
Marky’s server lives on the web, so the small mcp-remote helper (run by
npx) bridges the two. You need Node.js installed
for npx to work. The key is kept in the env block on purpose: that way
the space in Bearer mk_live_... is passed as one piece, not split apart. list_businesses, generate_posts,
create_post, schedule_post, get_post, and more). Try:
“List my Marky businesses.”
Claude will call list_businesses and show your workspaces. Each one has an
id you’ll use as the business_id for everything else.
Option B: REST in your CLAUDE.md
If you’d rather not use MCP, add these instructions to your project’s
CLAUDE.md and let Claude call the REST API with curl:
## Marky API: Social Media Posting
Base URL: https://api.mymarky.ai/api
Auth header: Authorization: Bearer mk_live_YOUR_KEY
### Start here (read-only)
- GET /businesses to list workspaces. Copy the `id` you want; that's your business_id.
### Generate a batch of on-brand posts (the easy path)
1. POST /posts/generate with {"business_id": "BIZ_ID", "content": "what to post about", "count": 5}
Returns {"job_id": "..."}. Brand voice, colors, and logo come from the business automatically.
2. GET /jobs/{job_id} every few seconds until status is "completed". The result lists the new draft posts.
3. GET /posts?business_id=BIZ_ID&status=NEW to review the drafts.
4. POST /posts/{id}/schedule with {"publish_at": "2026-12-01T14:00:00Z"} for each post.
### Create one post yourself
- POST /posts with {"business_id": "BIZ_ID", "caption": "text", "restrict_publish_to": ["instagram", "facebook"]}
- POST /posts/{id}/schedule with {"publish_at": "2026-12-01T14:00:00Z"}
### Check status
- GET /posts/{id} and read `publish_results`. Poll until every entry is "success" or "failed".
### Error format
All errors return: {"error": {"type": "...", "code": "...", "message": "...", "doc_url": "..."}}
Example: a week of posts
Ask Claude Code:
“Generate 5 posts about our spring coffee blend, then schedule one each
weekday at 9am.”
Claude will:
- Call
list_businesses to find your business_id.
- Call
generate_posts with your topic and count: 5, then poll get_job_status until it finishes.
- Review the drafts with
list_posts (status NEW).
- Call
schedule_post on each one with the time you asked for.
Claude Cowork: install Marky skills
Marky also ships agent skills as plugins for Claude Cowork. Install them from
the Marky-Team/marky-skills marketplace:
- Open the Claude Desktop App and navigate to the Cowork tab.
- Click on the Customize menu in the left sidebar to pull up your unified workspace hub.
- Open the Plugins tab and look down for the Personal plugins section.
- Click the ”+” button and select “Add marketplace”.
- Select “Add from a repository” and paste the GitHub repository handle (Marky-Team/marky-skills) or git URL.
- Once synced, browse the newly populated catalog and click “Install” on the specific plugin you want to activate.
Before you start
- Connect your social accounts first. Connecting an Instagram, Facebook,
LinkedIn, etc. account is a one-time step in the Marky web app. The API can
see your connected accounts but cannot add new ones.
- Keep your API key in
.env, not in CLAUDE.md.
- Full reference: docs.mymarky.ai
- Send API feedback with
POST /api/feedback, or open a request.
