# SocialPoster remote MCP

SocialPoster.pro exposes a remote Model Context Protocol (Streamable HTTP) server that proxies the Agent API. Grok Bot, Cursor, and Claude.ai connect with one URL and a Bearer `sp_live_…` key. SocialPoster is not an official Cursor or xAI product. Draft, then wait for human approval before publishing.

Human UI: https://socialposter.pro/mcp
Grok Bot connect: https://socialposter.pro/grok-bot
Agent API contract: https://socialposter.pro/agent-docs
Skill: https://socialposter.pro/skills/grok-bot.md
Claude walkthrough: https://socialposter.pro/blog/claude-mcp-socialposter
MCP how-to: https://socialposter.pro/blog/grok-bot-mcp-socialposter
Cursor IDE: https://socialposter.pro/blog/cursor-mcp-social-scheduling

## Hermes and OpenClaw (REST)

Self-hosted agents use REST, not MCP:

- Hermes: https://socialposter.pro/pages/hermes.md
- OpenClaw: https://socialposter.pro/pages/openclaw.md
- Agents hub: https://socialposter.pro/agents

## Endpoint

MCP URL: https://zqfnpnlzynhugeivtrka.supabase.co/functions/v1/mcp
Health (no auth): https://zqfnpnlzynhugeivtrka.supabase.co/functions/v1/mcp/health
Header: `Authorization: Bearer sp_live_…`
Never paste the key in chat. Store it in a Grok Bot secret card, Cursor env, or Claude connector settings.

## Cursor mcp.json

```json
{
  "mcpServers": {
    "socialposter": {
      "url": "https://zqfnpnlzynhugeivtrka.supabase.co/functions/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SOCIALPOSTER_API_KEY}"
      }
    }
  }
}
```

## Claude.ai

1. Open https://claude.ai/settings/connectors
2. Add custom connector named SocialPoster
3. Paste the MCP URL
4. Authentication: Bearer token with the `sp_live_…` key

## Tools

Prefixed names are the Grok Bot contract. Short aliases (`whoami`, `list_projects`, `create_post`, `create_email`, …) keep Claude connectors working.

Read `main_platform`, `timezone`, and `posting_slots` from `socialposter_get_project` before scheduling. Do not invent a platform or time. Email tools draft reminders only — the human sends from Email Studio.