Cursor MCP

Post to social media from Cursor

Add Onlypult to .cursor/mcp.json and Cursor's agent can turn your README, release notes and assets into drafts and scheduled posts on 15+ networks.

  • One JSON block
  • Hosted or local
  • Uploads from disk

How to add Onlypult to Cursor

Put the config in .cursor/mcp.json for one project, or ~/.cursor/mcp.json for all of them. You can also add it from Cursor Settings → MCP.

MCP server URL https://mcp.onlypult.com/mcp

Runs on your machine, so the agent can upload files from your project with media_upload_file. Requires Node.js 18+ — Cursor runs the package on first use.

  1. 1

    In Onlypult, open Settings → API Keys and create a key. It starts with op_ and is shown once — copy it somewhere safe.

  2. 2

    Add the block below to .cursor/mcp.json and replace the key.

  3. 3

    Open Cursor Settings → MCP and check that onlypult is enabled and lists its tools.

Local package .cursor/mcp.json
{
  "mcpServers": {
    "onlypult": {
      "command": "npx",
      "args": ["-y", "@onlypult/mcp@latest"],
      "env": {
        "ONLYPULT_API_KEY": "op_your_api_key"
      }
    }
  }
}

Nothing to run locally. Media goes in by public URL or through the browser upload page.

  1. 1

    In Onlypult, open Settings → API Keys and create a key. It starts with op_ and is shown once — copy it somewhere safe.

  2. 2

    Add the block below to .cursor/mcp.json and replace the key.

  3. 3

    Check Cursor Settings → MCP for a green status and the tool list.

Hosted server .cursor/mcp.json
{
  "mcpServers": {
    "onlypult": {
      "type": "http",
      "url": "https://mcp.onlypult.com/mcp",
      "headers": {
        "Authorization": "Bearer op_your_api_key"
      }
    }
  }
}

Check it worked: in Agent chat ask “Show my connected social profiles in Onlypult”.

Cursor prompts that work

Cursor's agent sees your codebase, so posts come from real changes and real assets.

Announce what you built

“Read the last merged PR description and draft a LinkedIn post and an X post about the feature. Drafts only.”

Assets to posts

“Upload ./marketing/launch.mp4 and create an Instagram Reel and a YouTube Short draft titled “New in 2.4”.”

Content from docs

“Turn README.md into a five-post LinkedIn series, one every Monday at 10:00.”

Queue check

“What's scheduled in Onlypult for next week? List gaps and draft posts to fill them.”

Fix failures

“List failed posts from the last 7 days, explain why, and retry the retryable ones.”

Performance snapshot

“Show reach and engagement for our LinkedIn page this month versus last month.”

Skills for Cursor

Add the Onlypult skills to Cursor

Skills are plain SKILL.md files that teach Cursor’s agent the workflow around each Onlypult tool: the right mode, timezone, limits and fallbacks. Copy them into your project and the agent loads the right one when your request matches.

Install for Cursor

Clone the repository and copy the skills into .cursor/skills/, or into ~/.cursor/skills/ for every project.

Terminal
git clone https://github.com/onlypult/agent-skills.git
mkdir -p .cursor/skills
cp -r agent-skills/skills/* .cursor/skills/

Schedule a post

Draft, schedule or publish a post in the right timezone, on the right profile, with plan limits and platform options handled.

SKILL.md

Cross-post

Send one message to several networks, checking each platform’s text and media limits first.

SKILL.md

Reels, Shorts and Stories

Pick the right tool and flags for Instagram and Facebook Reels, YouTube Shorts and Stories.

SKILL.md

Upload media

Choose between a public URL, a browser upload and a direct upload from a local file path.

SKILL.md

Fix failed posts

Find what failed, explain why, fix the cause and retry only when a retry can work.

SKILL.md

Analytics report

Followers, reach, engagement and top posts, read correctly, with coverage gaps and derived metrics explained.

SKILL.md

Best time to post

Find the best days and hours from the engagement heatmap and schedule posts into those slots.

SKILL.md

Content calendar

Plan a week or a month around what already works, show the plan first, create posts after you approve.

SKILL.md

Hashtag sets

Manage a profile’s saved hashtag sets and reuse them instead of retyping tags.

SKILL.md

Your agent gets hands, not the publish button

Most "AI posting" setups are all-or-nothing. Onlypult lets you hand an agent the busywork and keep the final say — on every post.

Drafts by default

Ask for a draft and the agent sends is_draft: true. The post is saved to your calendar and goes nowhere until a person — or an explicit "publish now" — says so.

Per-tool permissions

In Claude, ChatGPT, Cursor and most MCP clients you approve tools one by one. Keep reads and drafts on "Always allow", leave publishing and deleting on "Ask every time".

Everything lands in your calendar

Every post an agent creates shows up in the Onlypult calendar next to your team’s posts. Edit it, reschedule it, or send it through approval before it goes live.

OAuth for chat apps, keys for code

Claude and ChatGPT connect with OAuth 2.1 — you sign in on onlypult.com and the chat app never sees your password. Coding agents use an op_ API key from Settings → API Keys.

Errors an agent can act on

Validation errors come back with a code and a retryable flag. The agent explains "your plan ends on the 5th, pick an earlier date" instead of retrying in a loop.

Prompt-injection aware

Captions and comments pulled in by analytics are marked as untrusted external content, so the agent summarizes them instead of following instructions hidden inside.

Every tool your agent gets

One MCP server covers the whole post lifecycle — context, publishing, media, hashtags, repair and analytics. 37 tools.

Posts & scheduling

14

Draft, schedule, publish, cross-post, edit, delete and repair.

posts_createposts_create_storyposts_create_reelsposts_create_shortsposts_publish_nowposts_cross_postposts_listposts_list_failedposts_getposts_updateposts_deleteposts_retryposts_retry_all_failedposts_limits

Analytics (read-only)

8

Reach, followers, top posts, best time, period over period.

analytics_profiles_listanalytics_metrics_listanalytics_overviewanalytics_audienceanalytics_postsanalytics_top_postsanalytics_best_timeanalytics_compare_periods

Account & profiles

6

Timezone, plan limits, connected profiles, boards and categories.

account_getprofiles_listprofiles_getprofiles_platforms_listprofiles_get_pinterest_boardsprofiles_get_youtube_categories

Hashtag sets

6

Reuse saved hashtag groups per profile instead of retyping them.

hashtags_listhashtags_createhashtags_deletehashtag_groups_createhashtag_groups_updatehashtag_groups_delete

Media

3

Public URLs, browser upload, or direct upload from disk.

media_get_upload_urlmedia_check_statusmedia_upload_file

Publish to 15+ networks from one chat

The agent picks profiles from your Onlypult workspace — every account you connected over official OAuth is available, with per-network options like Reels, Shorts, Stories, boards and first comments.

Cursor tips and troubleshooting

Connected, but 0 tools

Reload MCP in Cursor Settings → MCP and open a new chat. If it persists, toggle the server off and on.

Use Agent mode

MCP tools are called from Cursor's agent. If the agent doesn't use Onlypult, mention it explicitly: “use Onlypult to…”.

Don't commit the key

If .cursor/mcp.json is in git, keep Onlypult in the global ~/.cursor/mcp.json instead, or add the project file to .gitignore.

Approving tool calls

Cursor asks before running MCP tools unless auto-run is on. Keep auto-run off for posts_publish_now and posts_delete.

“Cannot schedule after your plan end date”

Posts can't be scheduled past your plan's end date. The agent reads it from account_get and should pick an earlier date or ask you to renew. This error is marked retryable: false, so a well-behaved agent stops instead of looping.

Cursor and Onlypult: FAQ

Can Cursor post to social media?

Yes. With the Onlypult MCP server, Cursor's agent can draft, schedule and publish posts to 15+ networks and attach files from your project.

Where do I put the Onlypult config in Cursor?

In .cursor/mcp.json inside the project, or in ~/.cursor/mcp.json to use it everywhere. Both use the same mcpServers block.

Hosted or local — which should I use?

Local, if the agent should upload images or videos from your disk. Hosted, if you only need text and public image URLs and don't want Node.js involved.

Is it included in my plan?

Yes. MCP is on every Onlypult plan, including the 7-day free trial.

MCP is included on every plan

  • Works on the 7-day free trial
  • No credit card to start
  • No separate developer tier
  • No per-profile API fee
See pricing

Turn commits into posts

Add one JSON block to Cursor and let the agent announce what you ship — as drafts you approve.

7-day free trial · No credit card · MCP and API on every plan

Try for free