Sprkly
Integrations

Connect Sprkly to your AI assistant.

Sprkly is a Model Context Protocol server. Paste one URL into Claude Cowork, ChatGPT, Cursor or any MCP client, sign in, and your assistant can read your posting queue and schedule posts for you.

MCP server URL
https://sprkly.app/api/mcp
What have I got queued this week?Schedule this to Instagram and TikTok on Thursday at 6pm.Check this caption against TikTok's rules before it goes out.Move everything from Friday to Monday morning.
Setup

Pick your client

Every one of these talks to the same endpoint. Hosted assistants sign in with OAuth; anything running locally can use an API key instead.

Claude Cowork

Sign in with OAuth

Give Cowork your posting queue so it can plan and schedule alongside the rest of your work.

  1. 1.Open Settings → Connectors.
  2. 2.Click Add custom connector.
  3. 3.Paste https://sprkly.app/api/mcp as the server URL.
  4. 4.Click Add, then Connect, and approve the permissions.
Server URL
https://sprkly.app/api/mcp

Cowork connects from Anthropic's cloud, not your laptop, so there is nothing to install locally.

Claude & Claude Desktop

Sign in with OAuth

Same connector across claude.ai, the desktop app and mobile — connect once.

  1. 1.Settings → Connectors → Add custom connector.
  2. 2.Enter https://sprkly.app/api/mcp.
  3. 3.Connect and approve.
Server URL
https://sprkly.app/api/mcp

On Team and Enterprise plans an owner adds the connector in Admin settings first; members then click Connect.

Claude Code

OAuth or API key

Schedule from the terminal, or let a coding agent post your changelog.

  1. 1.Add the server with the CLI.
  2. 2.Run /mcp inside Claude Code and authorise in the browser.
Terminal
claude mcp add --transport http sprkly https://sprkly.app/api/mcp

Claude Code runs its own OAuth flow on a loopback port. To skip the browser entirely, pass an API key instead: claude mcp add --transport http sprkly https://sprkly.app/api/mcp --header "Authorization: Bearer sk_live_…"

ChatGPT

Sign in with OAuth

Add Sprkly as a connector in developer mode.

  1. 1.Enable Developer mode in Settings → Advanced.
  2. 2.Open the Connectors tab and add a custom connector.
  3. 3.Enter https://sprkly.app/api/mcp and authorise.
Server URL
https://sprkly.app/api/mcp

Requires a Plus, Pro, Business, Enterprise or Edu plan with developer mode on.

Cursor

OAuth or API key

Post release notes and updates without leaving the editor.

  1. 1.Add the server to ~/.cursor/mcp.json.
  2. 2.Reload Cursor and authorise when prompted.
~/.cursor/mcp.json
{
  "mcpServers": {
    "sprkly": {
      "url": "https://sprkly.app/api/mcp"
    }
  }
}

VS Code

OAuth or API key

Works with Copilot Chat's agent mode and any MCP-aware extension.

  1. 1.Add the server to .vscode/mcp.json in your workspace.
  2. 2.Start the server from the MCP view.
.vscode/mcp.json
{
  "servers": {
    "sprkly": {
      "type": "http",
      "url": "https://sprkly.app/api/mcp"
    }
  }
}

Anything else

API key

n8n, Zapier AI, LangChain, your own agent — any MCP client, or plain HTTP.

  1. 1.Create an API key in Sprkly Settings → API Keys.
  2. 2.Send it as a bearer token. There is no exchange step.
curl
curl -s https://sprkly.app/api/mcp \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Capabilities

What your assistant can do

13 tools, split by whether they change anything. Assistants show you the write ones before they run.

Read only

Never changes anything.

  • Get account summary

    Plan tier, trial state, connected account count, scheduled post counts by status, and the next three upcoming posts. Never returns tokens or secrets.

  • Get billing summary

    Subscription status, current plan, period end, purchased handles and the last few billing events. No payment method details; the Stripe customer id is truncated.

  • Get approval status

    Whether a post is awaiting human review, approved or rejected, including reviewer notes and timestamps.

  • Get post status

    Full detail for one post: status, targets, scheduled and published times, permalink, and the failure reason if it did not publish.

  • List connected accounts

    Every social account linked to this Sprkly account: platform, handle, follower count, whether it is active, and whether it needs reconnecting. Never returns access tokens.

  • List posting targets

    The profile ids needed to target a post, with each one's platform and handle. Call this before sprkly_schedule_post.

  • List scheduled posts

    The post queue, newest first, with a caption preview, targets, status and failure reason. Supports a status filter and cursor pagination.

  • Validate against platform rules

    Check a caption against each target platform's posting rules before scheduling: caption length, media requirements, hashtag ceilings, whether links are clickable, required YouTube titles, and PII or prohibited-content warnings. Pure analysis — writes nothing.

Changes your schedule

Confirmed with you before running.

  • Delete a scheduled postDestructive

    Remove a post from the queue. This is a soft delete — the user can restore it from the Deleted tab for 30 days. Posts that have already published cannot be deleted this way. Always confirm with the user before calling.

  • Draft a post

    Compose a caption from a content hint and save it as a draft in Sprkly, shaped to the tightest caption limit among the target platforms. Returns a draft id; the draft appears under /drafts for the user to review.

  • Request human approval

    Submit a draft post for human review. Moves the post to pending_approval and returns an approval id to poll with sprkly_get_post_approval_status. Use this when the user wants a person to sign off before anything publishes.

  • Schedule a post

    Queue a post for publishing. Runs the same quota, duplicate-content and platform pre-flight checks as the Sprkly app. Instagram and TikTok require media at submission time; YouTube requires a title. Confirm the date, time and target accounts with the user first.

  • Reschedule or edit a post

    Change the caption, publish time, target accounts or attached media on a post that has not published yet. Only posts with status "scheduled" can be edited.

The limits are real, not advisory

  • There is no publish-now tool. Anything an assistant queues goes through the same publisher, the same plan limits and the same approval path as a post you make yourself.
  • Deleting is a soft delete you can undo for 30 days, and an assistant cannot touch a post that has already published.
  • An assistant only ever sees your own accounts, and an API key can be scoped to a subset of them.
  • Every tool call is written to an audit log. Disconnect any time from Settings.

Questions

Which AI assistants can connect to Sprkly?

Any client that speaks the Model Context Protocol. That includes Claude Cowork, claude.ai, Claude Desktop, Claude Code, ChatGPT in developer mode, Cursor, VS Code, and automation tools like n8n. Anything else can call the endpoint over plain HTTP with an API key.

Do I need to install anything?

No. Sprkly runs a hosted MCP server, so you paste one URL into your assistant and sign in. There is nothing to run on your machine and nothing to keep updated.

Can an AI assistant publish without asking me?

It can only schedule to accounts you have already connected, and only if you ask it to. You can also require human approval, so anything an assistant queues waits for you to sign off before it publishes. Posts that have already published cannot be deleted by an assistant at all.

What does it cost?

Nothing extra. MCP access is included on every paid Sprkly plan, and uses the same entitlement as the REST API.

Can I limit which accounts an assistant sees?

Yes. Scope an API key to specific accounts in Settings and the assistant can only read and post to those. Scopes also control whether it can write at all or only read.

Ready to hand off your calendar?

Start a free trial, connect your accounts, then paste the server URL into your assistant.