Docs

MCP Server

Connect Your AI Tool

Connect Your AI Tool

Connect your AI tool

Schedule & Chill is a remote MCP server. One URL, one API key, and your AI tool can schedule posts, upload video from your machine, and read your queue.

https://schedulenchill.com/mcp

Authentication is a static bearer token:

Authorization: Bearer YOUR_API_KEY

Create a key under Settings → API Keys. Use a token with * abilities (the default) — a restricted token will 401 on media uploads.

Two connection patterns

Every MCP client falls into one of two camps. Find yours below, or match the pattern.

Pattern A — native remote HTTP. The client accepts a URL plus custom headers. Nothing to install.

Pattern B — stdio bridge. The client only speaks stdio to a local process. Use mcp-remote, which bridges stdio to a remote HTTP MCP server:

npx -y mcp-remote https://schedulenchill.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Requires Node.js 18+. Nothing to install ahead of time — npx fetches it.


Claude Code

Pattern A. One command:

claude mcp add --transport http schedulenchill https://schedulenchill.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Then in any session: "Schedule a LinkedIn post for Tuesday 9am about our launch."

Check it registered with claude mcp list. Add --scope project to commit the server to a repo's .mcp.json and share it with your team (put the key in an env var first — do not commit it).

Claude Desktop

Pattern B. Claude Desktop's remote connectors expect OAuth, and this server uses a bearer token, so bridge it. Edit claude_desktop_config.json (Settings → Developer → Edit Config):

{
    "mcpServers": {
        "schedulenchill": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://schedulenchill.com/mcp",
                "--header",
                "Authorization: Bearer YOUR_API_KEY"
            ]
        }
    }
}

Restart Claude Desktop fully (quit, don't just close the window). The tools appear under the connectors icon.

Cursor

Pattern A. Create .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project:

{
    "mcpServers": {
        "schedulenchill": {
            "url": "https://schedulenchill.com/mcp",
            "headers": { "Authorization": "Bearer YOUR_API_KEY" }
        }
    }
}

Enable it under Settings → MCP.

VS Code (GitHub Copilot agent mode)

Pattern A. Create .mcp.json in your workspace:

{
    "servers": {
        "schedulenchill": {
            "type": "http",
            "url": "https://schedulenchill.com/mcp",
            "headers": { "Authorization": "Bearer YOUR_API_KEY" }
        }
    }
}

Open Chat, switch to Agent mode, and the tools appear in the tools picker.

Gemini CLI

Pattern A. Edit ~/.gemini/settings.json:

{
    "mcpServers": {
        "schedulenchill": {
            "httpUrl": "https://schedulenchill.com/mcp",
            "headers": { "Authorization": "Bearer YOUR_API_KEY" }
        }
    }
}

Verify with /mcp inside the CLI.

Codex CLI

Pattern B is the reliable route. Edit ~/.codex/config.toml:

[mcp_servers.schedulenchill]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://schedulenchill.com/mcp",
  "--header",
  "Authorization: Bearer YOUR_API_KEY",
]

Recent Codex builds can talk to streamable-HTTP servers directly, but that path has moved around between releases. The bridge works on every version.

Windsurf

Pattern A. Edit ~/.codeium/windsurf/mcp_config.json:

{
    "mcpServers": {
        "schedulenchill": {
            "serverUrl": "https://schedulenchill.com/mcp",
            "headers": { "Authorization": "Bearer YOUR_API_KEY" }
        }
    }
}

Zed

Pattern B, via Zed's context servers. In settings.json:

{
    "context_servers": {
        "schedulenchill": {
            "command": {
                "path": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://schedulenchill.com/mcp",
                    "--header",
                    "Authorization: Bearer YOUR_API_KEY"
                ]
            }
        }
    }
}

ChatGPT

Not supported directly yet — and we would rather say so than waste your afternoon.

ChatGPT's custom connectors authenticate with OAuth or no auth. They have no field for a static bearer header, which is what this server uses. Pointing a ChatGPT connector at the endpoint will fail authentication.

Two things that do work today:

  • Any ChatGPT surface that can call an HTTP API — use the REST API directly with the same key.
  • Run the bridge locally and drive it from a local MCP-capable client instead.

OAuth support is on the roadmap. It needs a full OAuth server, not a config change, which is why it is not here yet.

Any other MCP client

This covers Kimi, OpenClaw, Hermes, n8n, LangChain, CrewAI, custom agents, and anything else that speaks MCP.

Ask one question: can it take a remote MCP URL with custom headers?

  • Yes → Pattern A. URL https://schedulenchill.com/mcp, header Authorization: Bearer YOUR_API_KEY. The exact JSON key differs per client (url, httpUrl, serverUrl), so copy the shape its own docs use.
  • No, stdio only → Pattern B with the npx mcp-remote command above.

From your own code, use any MCP client library with the same URL and header. The server speaks standard streamable HTTP MCP — there is nothing bespoke to implement.

If your client isn't listed and you get it working, tell us and we'll add it.


Verify the connection

Ask your tool: "List my connected social accounts." It should call get_accounts and return your channels.

If nothing happens, work through these in order:

Symptom Cause Fix
Tools don't appear at all Client not restarted Fully quit and reopen — most clients read MCP config only at startup
401 Unauthorized Key wrong, expired, or revoked Generate a fresh key in Settings → API Keys
401 only on media upload Token lacks * abilities Create a new key with default (*) abilities
platform_unavailable Targeting a platform not open on your account Call get_accounts first — post only to what it returns
429 Too Many Requests Rate limit 60 requests/min on MCP. Back off and retry after Retry-After
Bridge errors mentioning npx Node.js missing or too old Install Node.js 18+

First things to try

Once connected, say these to your AI tool in plain language:

  • "List my connected social accounts."
  • "Draft a LinkedIn post about shipping our free tier, then schedule it for Tuesday 9am."
  • "Upload ~/Videos/demo.mp4 and schedule it to LinkedIn tomorrow morning."
  • "What's in my posting queue this week?"
  • "Cancel the post scheduled for Friday."

Uploading a video from your own machine works even for large files — see Uploading video from your computer. Your AI tool streams it in chunks rather than posting one huge request, so there's no size cliff.

What your AI tool can do

Full parameters in Tools.

Tool What it does
get_accounts List connected channels. Always call this first.
get_groups List saved channel groups
schedule_post Schedule or publish immediately
update_post Edit a draft or scheduled post
get_post Read one post and its per-channel status
list_scheduled See the queue
cancel_post Remove a scheduled post
upload_media Upload from a URL, or stream a local file of any size
browse_media Search the media library
get_stats Posting stats