Solnk MCP

A Model Context Protocol server for Solnk — let any MCP client (Claude, Cursor, your own agent) publish and schedule content across 9 social platforms through one tool surface: X, Instagram, TikTok, YouTube, Facebook, LinkedIn, Pinterest, Threads, and Bluesky.

It's a thin, stateless proxy to the Solnk public API: your API key is forwarded per request, and all auth/scope/quota enforcement happens server-side. No credentials are stored in this Worker.

Hosted endpoint

A managed instance runs at:

Code

https://mcp.solnk.com/mcp

Authenticate with a Solnk API key as a bearer token. Create one at https://solnk.com/settings/api-keys.

Code

Authorization: Bearer sk_...

Connect a client

Most MCP clients reach a remote HTTP server through mcp-remote. Example config (Claude Desktop / Cursor / any client using the standard mcpServers schema):

config.json

{
  "mcpServers": {
    "solnk": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.solnk.com/mcp",
        "--header",
        "Authorization:Bearer ${SOLNK_API_KEY}"
      ],
      "env": {
        "SOLNK_API_KEY": "sk_your_key_here"
      }
    }
  }
}

Clients with native Streamable HTTP support can connect to https://mcp.solnk.com/mcp directly and set the Authorization: Bearer sk_... header.

Tools

Tool	What it does
`solnk_list_accounts`	List connected social accounts (id, platform, username, status, capabilities). Call first to get `account_id`s.
`solnk_get_usage`	Plan limits and current usage — check `can_publish` before posting.
`solnk_publish`	Publish to one or more platforms in a single request (`immediate`, `scheduled`, or `draft`).
`solnk_confirm_publish`	Confirm a draft so it goes out, now or scheduled.
`solnk_cancel_publish`	Cancel a draft or not-yet-sent scheduled publish.
`solnk_get_publish_status`	Aggregate status of a publish.
`solnk_list_publishes`	List recent publishes with filters.
`solnk_get_post_analytics`	Rolled-up or per-platform post metrics, including live post URLs.
`solnk_create_media_upload`	Presigned upload for a local image/video file (3-step flow).
`solnk_confirm_media_upload`	Finalize a presigned upload.
`solnk_create_media_from_url`	Ingest an image/video by public URL in one call.

Full request/response shapes and per-platform options live at developers.solnk.com.

Self-hosting

The server is a single Cloudflare Worker.

bash

pnpm install

# Local dev — point at your own Solnk API base if needed
# (edit SOLNK_API_BASE in wrangler.toml, e.g. http://localhost:3002/api/v1)
pnpm dev

# Deploy to your own Cloudflare account
pnpm deploy

wrangler.toml:

SOLNK_API_BASE — the Solnk public API the tools proxy to (defaults to https://api.solnk.com/api/v1).
routes — bind your own custom domain.

No secrets are needed at deploy time; the API key is supplied by the client at request time.

Discovery without a key

MCP discovery (initialize / tools/list) is open — clients, inspectors, and directories can introspect the tool surface without an API key. A key is only required to actually invoke a publishing tool. A Dockerfile is included so the Worker can be built and run locally (wrangler dev, no Cloudflare login) for introspection.

Solnk MCP README