Onlypult MCP Server

Connect AI agents — Claude, Cursor, ChatGPT, Windsurf, Codex, Antigravity, and any MCP-compatible client — directly to your Onlypult account via Model Context Protocol. Let AI publish, schedule, and manage your social content.

What you can do

Ask your AI assistant things like:

• "Show my connected social profiles"
• "Post 'Hello world!' to Instagram now"
• "Schedule a LinkedIn post for tomorrow at 9am"
• "Cross-post this to Instagram and Facebook"
• "Post this image to Instagram" (with browser upload flow)
• "List my failed posts and retry them"
• "Create an Instagram Reels post with this video"

Setup

The hosted MCP server at mcp.onlypult.com requires no local installation. Configure your AI client to connect over HTTP, then authenticate.

Authentication

The MCP server supports two authentication methods depending on how your AI client connects.

OAuth 2.1

When adding the hosted MCP server to Claude.ai, ChatGPT or other cloud AI platforms, authentication happens via OAuth 2.1 Authorization Code + PKCE. The AI client redirects the user to the Onlypult consent page — no manual API key setup required.

How the flow works

OAuth endpoints

Pre-registered clients

These clients are pre-registered and don't need dynamic registration:

• claude — redirect to https://claude.ai/api/mcp/auth_callback
• chatgpt — redirect to https://chatgpt.com/aip/p/mcp/auth_callback

Any other client can register dynamically via POST /register per RFC 7591.

Connect Cursor

Cursor supports two setups. Pick based on whether you need local file upload (media_upload_file) from disk paths in your project.

Option A — Local package (recommended for file uploads)

Installs automatically via npx. The MCP server runs on your machine (stdio), so it can read workspace files and upload them with media_upload_file.

Add to .cursor/mcp.json in your project root, or to global Cursor MCP settings:

{
  "mcpServers": {
    "onlypult": {
      "command": "npx",
      "args": ["-y", "@onlypult/mcp@latest"],
      "env": {
        "ONLYPULT_API_KEY": "op_your_api_key_here"
      }
    }
  }
}Copy

Requires Node.js 18+. No separate npm install — Cursor runs the package on first use.

Option B — Hosted HTTP (no install)

Connect directly to mcp.onlypult.com. Same tools except local disk upload — use the browser upload flow for images and videos.

{
  "mcpServers": {
    "onlypult": {
      "type": "http",
      "url": "https://mcp.onlypult.com/mcp",
      "headers": {
        "Authorization": "Bearer op_your_api_key_here"
      }
    }
  }
}Copy

Get your API key — see Authentication guide.

Connect Claude Desktop

Claude Desktop supports the same two modes as Cursor. claude_desktop_config.json is stdio-only (command + args) — use the local package there. For the hosted server, add a connector in the app UI (not type: http in the JSON file).

{
  "mcpServers": {
    "onlypult": {
      "command": "npx",
      "args": ["-y", "@onlypult/mcp@latest"],
      "env": {
        "ONLYPULT_API_KEY": "op_your_api_key_here"
      }
    }
  }
}Copy

Restart Claude Desktop after saving the config file or adding a connector.

Other MCP clients

Any MCP-compatible app can connect to Onlypult. Config file location varies; the JSON shape is the same.

Examples: Windsurf (.windsurf/mcp.json), Cursor (.cursor/mcp.json), Claude Desktop (claude_desktop_config.json), OpenAI Codex, Google Antigravity — check your app's MCP / Integrations settings and paste the same block as in Cursor local setup or hosted HTTP setup, depending on whether the client supports remote servers.

Local stdio template (copy into your client's MCP config):

{
  "mcpServers": {
    "onlypult": {
      "command": "npx",
      "args": ["-y", "@onlypult/mcp@latest"],
      "env": {
        "ONLYPULT_API_KEY": "op_your_api_key_here"
      }
    }
  }
}Copy

Connect Claude.ai

Claude.ai connects to Onlypult via OAuth 2.1 — no API key needed. Add a custom connector in settings, authorize once, then use MCP tools directly in chat.

Quick summary:

1. Settings → Connectors — click Add → Add custom connector
2. Name Onlypult, URL https://mcp.onlypult.com/mcp → Add
3. Click Connect → sign in with Onlypult → Allow access
4. In chat, ask e.g. Show my connected social profiles — approve tool calls when prompted

Connect ChatGPT

ChatGPT connects to Onlypult via OAuth 2.1 — no API key paste. There are two ways to add the MCP server, depending on your ChatGPT plan and available settings.

Option A — Custom Connectors (Plus / Pro)

Available on paid plans: Settings → Connectors → Add custom connector.

https://mcp.onlypult.com/mcpCopy

Option B — Developer mode (free)

Quick summary:

1. Settings → App Preferences → Apps — enable Developer mode in Advanced settings
2. Create app — name Onlypult, Server URL https://mcp.onlypult.com/mcp, Authentication OAuth
3. Connect → Sign in with Onlypult → Allow access
4. In chat, type @Onlypult before your request (e.g. @Onlypult Show my connected social profiles)

Available Tools

The tool reference is split in two — pick the one you need:

All tools share the same connection and credentials described above — connect once, and both groups are available in the same MCP session.