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 MCP server exposes hand-crafted tools for profiles, posts, and media. Call profiles_list first to discover profile IDs before creating posts.

Profiles

Posts

Media

Tool Reference

Detailed parameters for each MCP tool. Required fields must always be provided; optional fields can be omitted.

{
  "instagram": { "is_reels": true },
  "youtube": { "is_shorts": true, "privacy": "public", "category": "22" }
}Copy

Example conversations

Uploading images & videos

Onlypult supports three ways to attach media. The assistant picks the right one based on where the MCP server runs and where the file lives.

Local file upload (stdio / @onlypult/mcp)

With the local npm package in any stdio-capable MCP client, give a file path on your machine, for example:

Post ./marketing/video.mp4 to Instagram as a ReelCopy

The assistant calls media_upload_file, gets a file ID, and creates the post — no browser step.

Browser upload (remote MCP)

For hosted MCP connections, the server cannot read your disk. The assistant generates a one-time link; you upload in the browser; the assistant picks up file IDs.

Ask to create an upload link

Say something like: "I want to post an image to Instagram" or "Attach this video to my scheduled post".

The assistant calls media_get_upload_url and returns a unique link, for example:

https://app.onlypult.com/mcp-upload?token=abc123...Copy

For Stories or Reels, mention it upfront — the assistant will pass is_story or is_reels to the upload tool and use the matching post tool (posts_create_story, posts_create_reels).

Upload your file

Open the link in any browser. You'll see a simple upload page where you can choose files or drag & drop. Multiple files can be uploaded in one session.

• No Onlypult login required — the link is tied to your API key session
• The link expires in 10 minutes
• After upload, the page shows each file with its ID

Confirm upload

Return to your AI assistant and say "done" or "uploaded". The assistant calls media_check_status with the token, retrieves file IDs, and creates or updates the post with media_ids.

If upload is still processing, the assistant will ask you to wait a moment and check again.

Supported file types

• Images: JPG, PNG, WebP, GIF
• Videos: MP4, MOV, WebM

Maximum file size: depends on your Onlypult plan (shown on the upload page).

Example: posting with an image

Example: Reels with video