MCP integration

StackSweller exposes a Model Context Protocol (MCP) server that lets AI assistants like Claude read and manage your account directly — creating notes, scheduling content, browsing analytics, and more, all through natural language.

ℹ️ Note

MCP integration requires a Growth or Premium plan. Generate your API key in Settings → API Keys.

How it works

You generate an API key in StackSweller Settings
You add the StackSweller MCP server to your AI client (Claude Code, Claude Desktop, or Claude.ai)
The AI can now call StackSweller tools on your behalf — reading your schedule, creating drafts, checking analytics

All requests go through your StackSweller account and respect your subscription limits.

Generate an API key

Go to Settings → API Keys
Click Generate new key
Copy the key — you won’t be able to see it again

Keep this key private. Anyone with it can access your StackSweller account.

Setup: Claude Code

Claude Code reads MCP config from .mcp.json in your project directory, or from ~/.claude/mcp.json globally.

Add StackSweller to your global config (~/.claude/mcp.json):

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

Then restart Claude Code. You should see StackSweller tools available in your session.

💡 Tip

To confirm it’s working, ask Claude: “List my scheduled notes” — it should call the StackSweller tool and return your queue.

Setup: Claude Desktop

Open Claude Desktop
Go to Settings → Developer → Edit Config (opens claude_desktop_config.json)
Add the StackSweller server under mcpServers:

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

Save and restart Claude Desktop

The StackSweller tools will appear as available integrations in your Claude conversations.

Setup: Claude.ai

Claude.ai supports MCP via remote servers (no local config file needed).

Go to claude.ai and open Settings
Navigate to Integrations (or Connections)
Click Add integration and select Custom MCP server
Enter the following:
- Name: StackSweller
- URL: https://mcp.stacksweller.com/mcp
- Auth type: Bearer token
- Token: your API key
Click Save

Claude.ai will connect to StackSweller and make the tools available in new conversations.

⚠️ Warning

Claude.ai MCP support is currently in beta and available to Pro/Team subscribers. The exact steps above may vary slightly as Anthropic rolls it out.

Available tools

Once connected, Claude can use these StackSweller tools:

Notes

Tool	What it does
`list_scheduled_notes`	List scheduled, published, or missed notes
`schedule_note`	Schedule a new note at a specific time or next available slot
`create_draft`	Create an unscheduled draft note
`update_scheduled_note`	Edit a note that hasn’t published yet
`cancel_scheduled_note`	Cancel a scheduled note
`bulk_schedule_notes`	Schedule multiple notes to the next available slots
`list_drafts`	List your draft notes
`delete_draft`	Delete a draft permanently
`schedule_drafts`	Schedule existing drafts by ID

Scheduling slots

Tool	What it does
`list_slots`	List your recurring publishing slots
`next_empty_slots`	Show upcoming slots with no note assigned
`create_slot`	Create a new recurring slot
`update_slot`	Update a slot’s time or days
`delete_slot`	Delete a slot

Analytics & search

Tool	What it does
`top_performing_notes`	Top notes ranked by likes + restacks + comments
`search_notes`	Full-text search across published notes and drafts
`list_posts`	List Substack posts with engagement stats

Example prompts

Here are prompts that work well once you’re connected:

“What notes do I have scheduled this week?”
“Schedule a note for tomorrow at 9am: [paste content]”
“What were my top 5 notes last month?”
“Find my notes about productivity”
“Show me my next 3 empty scheduling slots”
“Create a draft: [paste content]”
“Schedule all my current drafts to the next available slots”

Troubleshooting

“Invalid or expired API key” — Regenerate your key in Settings → API Keys and update your config.

Tools don’t appear in Claude — Restart your client after adding the config. In Claude Code, run /mcp to verify the server is connected.

“Subscription required” — MCP requires a Growth or Premium plan. Upgrade at stacksweller.com/pricing.

Rate limit errors — The MCP server allows 60 tool calls per minute per API key. Space out bulk operations or use bulk_schedule_notes instead of scheduling one by one.

Questions? Email lakshmi@stacksweller.com.