MCP server
TimeToPost is the timing-aware publishing layer built for humans and AI agents. Its official Model Context Protocol (MCP) server exposes 35 tools for drafting, scheduling, publishing, approvals, analytics, AutoSEO and scheduler health. There is nothing to install and no API keys: add it to Claude Code, Claude Desktop, Cursor, or any MCP-compatible client and your agent works under your account permissions.
Setup: hosted server (no API keys)
The hosted server at https://api.timetopost.co/mcp uses OAuth. On first use your browser opens, you sign in with your email and a 6-digit code, click Approve access, done. Nothing to install, no tokens to copy.
Claude Code
One CLI command:
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
Add { "url": "https://api.timetopost.co/mcp" } under mcpServers.timetopost in your client’s mcp.json and enable the server when prompted.
First use opens your browser to sign in and approve access. Revoke access anytime from Settings → API. To verify the connection, ask your agent to run the whoami tool. It should return your user and active organization.
Tool reference
| 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. |
| 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. |
Example prompts
- “Schedule these 5 captions across Instagram and X at my optimal times this week.”
- “What was my engagement last month? Which platform performed best?”
- “Cancel everything scheduled for Friday and move it to Monday morning.”
Security model
The MCP server is a thin adapter over the same REST API the web app uses. Every tool call carries your authorized access, 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. Revoke an agent’s access any time from Settings → API.
For the product story and FAQ, see the MCP overview page.