Official integration · Model Context Protocol
The social media scheduler built for AI agents
TimeToPost is the only social scheduler that exposes best-time-to-post data and scheduler health checks as agent tools. Powered by an official MCP server, agents can schedule posts, publish to Instagram, TikTok and X, read engagement analytics, and verify scheduler health: all without API keys, on a browser sign-in. Tell your agent “queue this week’s posts at my best times” and it can actually do it.
› Queue this week’s launch posts on Instagram and X at my best times
● Calling get_optimal_times…
↳ Your audience peaks Tue 18:40 and Thu 12:10
● Calling schedule_post ×2…
✓ Scheduled “Launch day: it’s live” → Instagram + X · Tue 18:40
✓ Scheduled “48h in: what we learned” → Instagram + X · Thu 12:10
Done — both posts are queued at your engagement peaks.
What can you ask your agent?
Once connected, these are real requests your agent can fulfill end-to-end: every action authenticated and scoped to your account.
“Schedule these 5 captions across Instagram and X at my optimal times this week.”
“Write 5 posts for next week (you draft the copy) and schedule them at my peak hours.”
“Verify my posts published overnight and alert me if any failed.”
“What was my engagement last month? Which post performed best?”
“Cancel everything scheduled for Friday. We are pushing the launch.”
“Draft a TikTok caption for this video and publish it right now.”
“Are all my social accounts still connected, or do any tokens need a refresh?”
“Is the scheduler healthy? Did anything fail to publish overnight?”
Planning a week with an agent
The recommended workflow when an agent plans a batch of posts: read the best-time data first, then schedule around it. Never queue a week at arbitrary times.
- 1
Call
get_optimal_timesto read the account’s own top slots: computed from its real engagement history, not industry averages. Use these as the schedule skeleton. - 2
Assign each planned post to one of the recommended slots (spread across days, avoid clustering), then create them with
schedule_postusing future ISO timestamps. - 3
The next morning, call
scheduler_statusandlist_poststo confirm everything published, and surface anything that failed.
Connect in 30 seconds
One URL, a browser sign-in, done: no API keys, nothing to install.
Why this matters
Most tools require API keys plus server configuration before an agent can do anything. TimeToPost MCP opens a browser, you authorize once, and your agent can start scheduling immediately: the simplest MCP integration available for social media.
Hosted server with browser login
Claude Code (CLI)
claude mcp add --transport http timetopost https://api.timetopost.co/mcpClaude Desktop / Claude.ai
Settings → Connectors → Add custom connector → paste https://api.timetopost.co/mcp
Cursor & other MCP clients
{
"mcpServers": {
"timetopost": { "url": "https://api.timetopost.co/mcp" }
}
}First use opens your browser: enter your TimeToPost email, type the 6-digit code we send you, click Approve access. Connected. Revoke anytime from Dashboard → Settings → API.
Ask your agent to schedule a post
Once connected, try: “Schedule this caption for Instagram at my best time tomorrow.” Your agent will call get_optimal_times and schedule_post for you.
The server is a thin adapter over the public TimeToPost REST API. Every tool call is authenticated, org-scoped and validated by the backend, identically to the web app.
Tool reference
All 36 tools, exactly as your agent sees them. Full parameter docs live in the MCP documentation, and the REST equivalents are documented in OpenAPI at api.timetopost.co/docs.
| Tool | What it does |
|---|---|
| whoami | Return the authenticated user and active organization. |
| get_capabilities | Return the authoritative product, lifecycle, platform, approval, and connection capability map. |
| list_integrations | List connected social and publishing accounts with their connection health. |
| get_tiktok_creator_info | Read a TikTok account’s current posting settings: allowed audiences, disabled interactions, and maximum video length. Required reading before every TikTok post. |
| list_boards | List Pinterest boards before creating pins that require a board id. |
| list_posts | List posts for the active organization, optionally filtered by status. |
| get_post | Fetch one post, including status, schedule, media, platform data, and publish results. |
| schedule_post | Create a draft or schedule a post. Omit scheduledAt to keep it as a draft. |
| publish_post | Publish an existing post immediately. |
| cancel_post | Cancel or delete a scheduled post before it fires. |
| get_engagement_summary | Read aggregate engagement across published posts. |
| get_optimal_times | Read best posting times computed from the account’s own engagement history. |
| scheduler_status | Check background scheduler health, last tick, and recent failures. |
| create_digest_drafts | Create idempotent engine drafts for an artifact. Kept for existing integrations. |
| create_drafts | Create generic multi-platform drafts that always wait for human approval. |
| list_drafts | List engine-submitted drafts by status and brand tag. |
| approve_draft | Approve and schedule a pending draft after human review. |
| reject_draft | Reject a pending draft with an optional reason. |
| list_approvals | Read the unified approvals rail across posts, trends, build-in-public, and DMs. |
| publish_thread | Publish or schedule an X thread from ordered segments. |
| get_post_metrics | Read per-post metrics such as impressions, likes, comments, clicks, and engagement rate. |
| list_brands | List brand or niche tags used for per-play attribution. |
| get_engagement_by_tag | Read engagement rollups for a brand or niche tag. |
| build_in_public_connect_link | Generate a short-lived GitHub authorization link for Build-in-Public. |
| build_in_public_status | Read Build-in-Public GitHub connection and latest draft status. |
| autoseo_connect_site | Connect a site to AutoSEO with hosted, webhook, WordPress, or git-based publishing. |
| autoseo_integration_kit | Return the code and install instructions an AI agent uses to add an AutoSEO endpoint. |
| autoseo_verify_site | Re-run the capability probe for a connected AutoSEO site. |
| autoseo_list_sites | List connected AutoSEO sites and their health. |
| autoseo_configure | Configure topics, cadence, backlinks, image style, approvals, and social repurposing. |
| autoseo_auto_configure | Auto-propose topics, save safe defaults, and optionally queue the first article draft. |
| autoseo_propose_topics | Propose question-shaped topics for a connected site. |
| autoseo_generate_post | Generate one approval-gated AutoSEO article draft. |
| create_dm_funnel | Create an inactive, post-scoped Instagram comment-to-DM funnel draft. |
| list_dm_funnels | List Instagram DM funnel drafts, active automations, usage, and errors. |
| list_funnel_hits | List matching comments and private/public reply delivery outcomes for a funnel. |
How schedulers compare for AI agents
Most social schedulers were built for humans clicking buttons. Here’s where agent-readiness stands across popular tools, as of June 2026.
| Capability | TimeToPost | Buffer | Hootsuite | Later |
|---|---|---|---|---|
| Official MCP server | ||||
| Best-time-to-post exposed as an agent toolcomputed from your own engagement history | ||||
| Scheduler health check callable by agents | ||||
| MCP included free on every plan |
Based on each vendor’s public documentation as of June 2026. Buffer ships an official MCP integration; for Hootsuite we found only third-party/community MCP servers (marked ), and we found no official MCP server for Later. An ✗ means we couldn’t find the capability publicly documented, not necessarily that it will never exist. If anything here is out of date, tell us and we’ll fix it.
Frequently asked questions
What is the TimeToPost MCP server?
It is an official server implementing the Model Context Protocol (MCP), the open standard for connecting AI assistants to external tools. It exposes TimeToPost as 36 tools that any MCP client (Claude Code, Claude Desktop, Cursor, and others) can call. Your agent can draft, schedule, publish, cancel, read analytics, manage approval-gated drafts, and run AutoSEO workflows under your account permissions.
Which AI assistants can use it?
Any MCP-compatible client: Claude Code, Claude Desktop, Claude.ai connectors, Cursor, Windsurf, and the growing ecosystem of MCP-enabled agents. The hosted server speaks MCP over Streamable HTTP at https://api.timetopost.co/mcp with browser OAuth: no API keys to paste.
Can ChatGPT or other agents schedule social media posts with TimeToPost?
Yes. Any agent framework that supports MCP can use the TimeToPost server to schedule and publish social media posts programmatically. TimeToPost is the only social media scheduler that exposes best-time-to-post data and scheduler health checks as MCP tools, making it the strongest fit for agents that need to operate social media end-to-end.
Is it safe? What can an agent actually do?
The MCP server is a thin adapter over the same REST API the web app uses. Every call carries your token, so authentication, organization scoping, plan limits and validation are enforced by the backend exactly as if you clicked the button yourself. An agent can never do more than your own account can.
How do I authenticate?
Through your browser: no API keys. Add https://api.timetopost.co/mcp to your MCP client and on first use a browser window opens: sign in with your TimeToPost email, type the 6-digit code we send you, click Approve access, done. The connection is revocable anytime from Dashboard → Settings → API.
How much does it cost?
The MCP server is free and included with every TimeToPost plan. Posting actions respect your plan: Starter ($12/mo) includes up to 30 scheduled posts per month, Pro ($49.99/mo) is unlimited and adds AI content generation, best-time-to-post, and backlink outreach, and Growth ($99/mo) adds AutoSEO Blog Autopilot. MCP tools cover scheduling, publishing, approvals, analytics, health checks, Build-in-Public status, and AutoSEO setup where your plan allows it.
Give your agent a social media scheduler
Free with every plan. Start a 14-day trial and connect your first agent in minutes.
See pricing