[{"data":1,"prerenderedAt":844},["ShallowReactive",2],{"navigation":3,"\u002Fgetting-started\u002Fai-mcp":188,"\u002Fgetting-started\u002Fai-mcp-surround":839},[4,38,58,152],{"title":5,"path":6,"stem":7,"children":8,"icon":37},"Getting Started","\u002Fgetting-started","1.getting-started\u002F1.index",[9,12,17,22,27,32],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-house",{"title":13,"path":14,"stem":15,"icon":16},"Authentication","\u002Fgetting-started\u002Fauthentication","1.getting-started\u002F2.authentication","i-lucide-key",{"title":18,"path":19,"stem":20,"icon":21},"Error Handling","\u002Fgetting-started\u002Ferrors","1.getting-started\u002F3.errors","i-lucide-alert-circle",{"title":23,"path":24,"stem":25,"icon":26},"GraphQL Types","\u002Fgetting-started\u002Ftypes","1.getting-started\u002F4.types","i-lucide-shapes",{"title":28,"path":29,"stem":30,"icon":31},"Rate Limits","\u002Fgetting-started\u002Frate-limits","1.getting-started\u002F5.rate-limits","i-lucide-gauge",{"title":33,"path":34,"stem":35,"icon":36},"AI & MCP","\u002Fgetting-started\u002Fai-mcp","1.getting-started\u002F6.ai-mcp","i-lucide-bot",false,{"title":39,"icon":37,"path":40,"stem":41,"children":42,"page":37},"Queries","\u002Fqueries","2.queries",[43,48,53],{"title":44,"path":45,"stem":46,"icon":47},"User","\u002Fqueries\u002Fuser","2.queries\u002F1.user","i-lucide-user",{"title":49,"path":50,"stem":51,"icon":52},"Social Accounts","\u002Fqueries\u002Fsocial-accounts","2.queries\u002F2.social-accounts","i-lucide-users",{"title":54,"path":55,"stem":56,"icon":57},"Content Library","\u002Fqueries\u002Fcontent-library","2.queries\u002F3.content-library","i-lucide-image",{"title":59,"path":60,"stem":61,"children":62,"icon":37},"Scheduling Posts","\u002Fscheduling-posts","3.scheduling-posts\u002F01.index",[63,64,69,74,79,84],{"title":10,"path":60,"stem":61,"icon":11},{"title":65,"path":66,"stem":67,"icon":68},"Managing Posts","\u002Fscheduling-posts\u002Fexample-mutations","3.scheduling-posts\u002F2.example-mutations","i-lucide-pencil-ruler",{"title":70,"path":71,"stem":72,"icon":73},"Post Tags","\u002Fscheduling-posts\u002Fpost-tags","3.scheduling-posts\u002F3.post-tags","i-lucide-tags",{"title":75,"path":76,"stem":77,"icon":78},"Retrieving Posts","\u002Fscheduling-posts\u002Fretrieving-posts","3.scheduling-posts\u002F4.retrieving-posts","i-lucide-search",{"title":80,"path":81,"stem":82,"icon":83},"Next Scheduled Dates","\u002Fscheduling-posts\u002Fnext-scheduled-dates","3.scheduling-posts\u002F5.next-scheduled-dates","i-lucide-calendar-clock",{"title":85,"path":86,"stem":87,"children":88,"icon":37},"Platforms","\u002Fscheduling-posts\u002Fplatforms","3.scheduling-posts\u002Fplatforms\u002F01.index",[89,92,97,102,107,112,117,122,127,132,137,142,147],{"title":90,"path":86,"stem":87,"icon":91},"All Platforms","i-lucide-network",{"title":93,"path":94,"stem":95,"icon":96},"Reddit","\u002Fscheduling-posts\u002Fplatforms\u002Freddit","3.scheduling-posts\u002Fplatforms\u002F02.reddit","i-simple-icons-reddit",{"title":98,"path":99,"stem":100,"icon":101},"X\u002FTwitter","\u002Fscheduling-posts\u002Fplatforms\u002Ftwitter","3.scheduling-posts\u002Fplatforms\u002F03.twitter","i-simple-icons-x",{"title":103,"path":104,"stem":105,"icon":106},"Instagram","\u002Fscheduling-posts\u002Fplatforms\u002Finstagram","3.scheduling-posts\u002Fplatforms\u002F04.instagram","i-simple-icons-instagram",{"title":108,"path":109,"stem":110,"icon":111},"Facebook","\u002Fscheduling-posts\u002Fplatforms\u002Ffacebook","3.scheduling-posts\u002Fplatforms\u002F05.facebook","i-simple-icons-facebook",{"title":113,"path":114,"stem":115,"icon":116},"Threads","\u002Fscheduling-posts\u002Fplatforms\u002Fthreads","3.scheduling-posts\u002Fplatforms\u002F06.threads","i-simple-icons-threads",{"title":118,"path":119,"stem":120,"icon":121},"Bluesky","\u002Fscheduling-posts\u002Fplatforms\u002Fbluesky","3.scheduling-posts\u002Fplatforms\u002F07.bluesky","i-simple-icons-bluesky",{"title":123,"path":124,"stem":125,"icon":126},"TikTok","\u002Fscheduling-posts\u002Fplatforms\u002Ftiktok","3.scheduling-posts\u002Fplatforms\u002F08.tiktok","i-simple-icons-tiktok",{"title":128,"path":129,"stem":130,"icon":131},"YouTube Shorts","\u002Fscheduling-posts\u002Fplatforms\u002Fyoutube","3.scheduling-posts\u002Fplatforms\u002F09.youtube","i-simple-icons-youtube",{"title":133,"path":134,"stem":135,"icon":136},"LinkedIn","\u002Fscheduling-posts\u002Fplatforms\u002Flinkedin","3.scheduling-posts\u002Fplatforms\u002F10.linkedin","i-simple-icons-linkedin",{"title":138,"path":139,"stem":140,"icon":141},"Pinterest","\u002Fscheduling-posts\u002Fplatforms\u002Fpinterest","3.scheduling-posts\u002Fplatforms\u002F11.pinterest","i-simple-icons-pinterest",{"title":143,"path":144,"stem":145,"icon":146},"Mastodon","\u002Fscheduling-posts\u002Fplatforms\u002Fmastodon","3.scheduling-posts\u002Fplatforms\u002F12.mastodon","i-simple-icons-mastodon",{"title":148,"path":149,"stem":150,"icon":151},"Tumblr","\u002Fscheduling-posts\u002Fplatforms\u002Ftumblr","3.scheduling-posts\u002Fplatforms\u002F13.tumblr","i-simple-icons-tumblr",{"title":153,"path":154,"stem":155,"children":156},"Analytics","\u002Fanalytics","4.analytics",[157,159,164,169,173,178,183],{"title":10,"path":154,"stem":158,"icon":11},"4.analytics\u002Findex",{"title":160,"path":161,"stem":162,"icon":163},"Post Time Series Metrics","\u002Fanalytics\u002Fpost-time-series-metrics","4.analytics\u002F1.post-time-series-metrics","i-lucide-trending-up",{"title":165,"path":166,"stem":167,"icon":168},"Aggregate Post Metrics","\u002Fanalytics\u002Faggregate-post-metrics","4.analytics\u002F2.aggregate-post-metrics","i-lucide-bar-chart-3",{"title":170,"path":171,"stem":172,"icon":52},"Aggregate Social Account Post Metrics","\u002Fanalytics\u002Faggregate-social-account-post-metrics","4.analytics\u002F3.aggregate-social-account-post-metrics",{"title":174,"path":175,"stem":176,"icon":177},"Post Tag Metrics","\u002Fanalytics\u002Fpost-tag-metrics","4.analytics\u002F4.post-tag-metrics","i-lucide-tag",{"title":179,"path":180,"stem":181,"icon":182},"Multi-Platform Analytics Submissions","\u002Fanalytics\u002Fmulti-platform-analytics-submissions","4.analytics\u002F5.multi-platform-analytics-submissions","i-lucide-list",{"title":184,"path":185,"stem":186,"icon":187},"Platform Metrics","\u002Fanalytics\u002Fplatform-metrics","4.analytics\u002F6.platform-metrics","i-lucide-layout-grid",{"id":189,"title":33,"body":190,"description":831,"extension":832,"links":833,"meta":834,"navigation":835,"path":34,"seo":836,"sitemap":837,"stem":35,"__hash__":838},"docs\u002F1.getting-started\u002F6.ai-mcp.md",{"type":191,"value":192,"toc":821},"minimark",[193,205,217,222,225,236,243,254,267,270,281,286,289,294,297,357,368,372,375,385,389,392,435,441,445,460,596,599,629,633,652,758,767,770,781,804,808,817],[194,195,196,197,204],"p",{},"Postpone ships a remote ",[198,199,203],"a",{"href":200,"rel":201},"https:\u002F\u002Fmodelcontextprotocol.io",[202],"nofollow","Model Context Protocol (MCP)"," server so AI agents can schedule and manage social media posts on your behalf using natural language. Connect it to clients like Claude, ChatGPT, Cursor, Perplexity, Grok, Zapier, n8n, Raycast, or any MCP-compatible tool.",[206,207,209],"alert",{"type":208},"info",[194,210,211,212,216],{},"The MCP server is in ",[213,214,215],"strong",{},"Beta",". The tools and protocol versions it supports may change.",[218,219,221],"h2",{"id":220},"mcp-server-url","MCP Server URL",[194,223,224],{},"There's a single endpoint for the Postpone MCP server:",[226,227,232],"pre",{"className":228,"code":230,"language":231},[229],"language-text","https:\u002F\u002Fapi.postpone.app\u002Fmcp\n","text",[233,234,230],"code",{"__ignoreMap":235},"",[194,237,238,239,242],{},"It speaks streamable HTTP (JSON-RPC over ",[233,240,241],{},"POST","). Server-Sent Events (SSE) are not supported.",[194,244,245,246,249,250,253],{},"The server negotiates MCP protocol versions ",[233,247,248],{},"2025-11-25"," and ",[233,251,252],{},"2025-06-18",", preferring the newest the client supports.",[206,255,256],{"type":208},[194,257,258,259,262,263,266],{},"A ",[213,260,261],{},"confirmed email address"," is required to use the MCP server. If your account email isn't confirmed yet, tool calls will fail with an ",[233,264,265],{},"email_not_confirmed"," error.",[218,268,13],{"id":269},"authentication",[194,271,272,273,276,277,280],{},"The MCP endpoint accepts two authentication methods: ",[213,274,275],{},"OAuth 2.1"," (recommended for interactive clients) and ",[213,278,279],{},"Bearer token"," (a personal API key, ideal for headless or self-hosted clients). Session cookies are deliberately not honored.",[282,283,285],"h3",{"id":284},"oauth","OAuth",[194,287,288],{},"Most hosted AI clients (Claude, ChatGPT, Cursor, and others) support OAuth out of the box. When you add Postpone as a custom\u002Fremote MCP server and choose OAuth, the client walks you through signing in to Postpone and approving access — no API key to copy or paste.",[290,291,293],"h4",{"id":292},"scopes","Scopes",[194,295,296],{},"OAuth access is scoped. When you approve a connection, you grant a set of scopes, and each tool requires a specific one:",[298,299,300,313],"table",{},[301,302,303],"thead",{},[304,305,306,310],"tr",{},[307,308,309],"th",{},"Scope",[307,311,312],{},"Grants",[314,315,316,327,337,347],"tbody",{},[304,317,318,324],{},[319,320,321],"td",{},[233,322,323],{},"posts:read",[319,325,326],{},"View your scheduled and published posts",[304,328,329,334],{},[319,330,331],{},[233,332,333],{},"posts:write",[319,335,336],{},"Create and delete scheduled posts",[304,338,339,344],{},[319,340,341],{},[233,342,343],{},"accounts:read",[319,345,346],{},"View your connected social accounts",[304,348,349,354],{},[319,350,351],{},[233,352,353],{},"media:read",[319,355,356],{},"Search and view media in your media library",[194,358,359,360,363,364,367],{},"If a tool call needs a scope you haven't granted, the server responds with ",[233,361,362],{},"403"," and an ",[233,365,366],{},"insufficient_scope"," error so the client can request step-up authorization.",[282,369,371],{"id":370},"bearer-token-api-key","Bearer token (API key)",[194,373,374],{},"Any client that lets you set request headers can authenticate with a Postpone API key as a Bearer token. This is the simplest path for self-hosted clients (n8n, custom scripts, and similar).",[206,376,378],{"type":377},"warning",[194,379,380,381,384],{},"Unlike OAuth, ",[213,382,383],{},"API key callers have full access"," — scope checks are bypassed. Treat your API key as a secret that can read and write all of your Postpone content. Never share it publicly.",[290,386,388],{"id":387},"creating-an-mcp-token","Creating an MCP token",[194,390,391],{},"API keys for MCP are the same personal API keys used for the GraphQL API:",[393,394,395,405,423,429],"ol",{},[396,397,398,399,404],"li",{},"Log into your Postpone account at ",[198,400,403],{"href":401,"rel":402},"https:\u002F\u002Fwww.postpone.app",[202],"postpone.app",".",[396,406,407,408,415,416,404],{},"Go to ",[198,409,412],{"href":410,"rel":411},"https:\u002F\u002Fwww.postpone.app\u002Fsettings\u002Fapi",[202],[213,413,414],{},"Settings → Integrations → Postpone API",". You can also reach the MCP setup guides under ",[198,417,420],{"href":418,"rel":419},"https:\u002F\u002Fwww.postpone.app\u002Fsettings\u002Fmcp",[202],[213,421,422],{},"Settings → AI Agents & MCP",[396,424,425,428],{},[213,426,427],{},"Create"," an API key. Give it a name and, optionally, an expiration date.",[396,430,431,434],{},[213,432,433],{},"Copy"," the key — this is the only time it's shown.",[194,436,437,438,404],{},"API access requires a confirmed email and a plan that includes API access. For more on keys, see the ",[198,439,440],{"href":14},"Authentication guide",[290,442,444],{"id":443},"using-the-token","Using the token",[194,446,447,448,451,452,455,456,459],{},"Send the key in the ",[233,449,450],{},"Authorization"," header using the ",[233,453,454],{},"Bearer"," scheme. Most clients accept a JSON config like this — replace ",[233,457,458],{},"API_KEY"," with your key:",[226,461,465],{"className":462,"code":463,"language":464,"meta":235,"style":235},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"mcpServers\": {\n    \"postpone\": {\n      \"url\": \"https:\u002F\u002Fapi.postpone.app\u002Fmcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer API_KEY\"\n      }\n    }\n  }\n}\n","json",[233,466,467,476,495,511,537,551,572,578,584,590],{"__ignoreMap":235},[468,469,472],"span",{"class":470,"line":471},"line",1,[468,473,475],{"class":474},"sMK4o","{\n",[468,477,479,482,486,489,492],{"class":470,"line":478},2,[468,480,481],{"class":474},"  \"",[468,483,485],{"class":484},"spNyl","mcpServers",[468,487,488],{"class":474},"\"",[468,490,491],{"class":474},":",[468,493,494],{"class":474}," {\n",[468,496,498,501,505,507,509],{"class":470,"line":497},3,[468,499,500],{"class":474},"    \"",[468,502,504],{"class":503},"sBMFI","postpone",[468,506,488],{"class":474},[468,508,491],{"class":474},[468,510,494],{"class":474},[468,512,514,517,521,523,525,528,532,534],{"class":470,"line":513},4,[468,515,516],{"class":474},"      \"",[468,518,520],{"class":519},"sbssI","url",[468,522,488],{"class":474},[468,524,491],{"class":474},[468,526,527],{"class":474}," \"",[468,529,531],{"class":530},"sfazB","https:\u002F\u002Fapi.postpone.app\u002Fmcp",[468,533,488],{"class":474},[468,535,536],{"class":474},",\n",[468,538,540,542,545,547,549],{"class":470,"line":539},5,[468,541,516],{"class":474},[468,543,544],{"class":519},"headers",[468,546,488],{"class":474},[468,548,491],{"class":474},[468,550,494],{"class":474},[468,552,554,557,560,562,564,566,569],{"class":470,"line":553},6,[468,555,556],{"class":474},"        \"",[468,558,450],{"class":559},"swJcz",[468,561,488],{"class":474},[468,563,491],{"class":474},[468,565,527],{"class":474},[468,567,568],{"class":530},"Bearer API_KEY",[468,570,571],{"class":474},"\"\n",[468,573,575],{"class":470,"line":574},7,[468,576,577],{"class":474},"      }\n",[468,579,581],{"class":470,"line":580},8,[468,582,583],{"class":474},"    }\n",[468,585,587],{"class":470,"line":586},9,[468,588,589],{"class":474},"  }\n",[468,591,593],{"class":470,"line":592},10,[468,594,595],{"class":474},"}\n",[194,597,598],{},"For Claude Code, add the server from your terminal:",[226,600,604],{"className":601,"code":602,"language":603,"meta":235,"style":235},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","claude mcp add --transport http postpone https:\u002F\u002Fapi.postpone.app\u002Fmcp\n","bash",[233,605,606],{"__ignoreMap":235},[468,607,608,611,614,617,620,623,626],{"class":470,"line":471},[468,609,610],{"class":503},"claude",[468,612,613],{"class":530}," mcp",[468,615,616],{"class":530}," add",[468,618,619],{"class":530}," --transport",[468,621,622],{"class":530}," http",[468,624,625],{"class":530}," postpone",[468,627,628],{"class":530}," https:\u002F\u002Fapi.postpone.app\u002Fmcp\n",[218,630,632],{"id":631},"available-tools","Available Tools",[194,634,635,636,639,640,643,644,647,648,651],{},"The Postpone MCP server exposes the following tools. Posting depends on IDs from other tools: get a ",[233,637,638],{},"social_account_id"," from ",[233,641,642],{},"postpone_list_social_accounts"," before creating a post, and ",[233,645,646],{},"media_id"," values from ",[233,649,650],{},"postpone_search_media"," before attaching content-library media.",[298,653,654,667],{},[301,655,656],{},[304,657,658,661,664],{},[307,659,660],{},"Tool",[307,662,663],{},"Required scope",[307,665,666],{},"Description",[314,668,669,689,703,717,731,745],{},[304,670,671,675,679],{},[319,672,673],{},[233,674,642],{},[319,676,677],{},[233,678,343],{},[319,680,681,682,685,686,688],{},"List the social media accounts connected to your Postpone account. Returns the ",[233,683,684],{},"id"," to pass as ",[233,687,638],{}," when creating posts.",[304,690,691,696,700],{},[319,692,693],{},[233,694,695],{},"postpone_list_scheduled_posts",[319,697,698],{},[233,699,323],{},[319,701,702],{},"List posts scheduled within the next 30 days across all connected platforms, ordered by scheduled time.",[304,704,705,710,714],{},[319,706,707],{},[233,708,709],{},"postpone_list_published_posts",[319,711,712],{},[233,713,323],{},[319,715,716],{},"List posts published in the last 30 days across connected platforms, most recent first.",[304,718,719,724,728],{},[319,720,721],{},[233,722,723],{},"postpone_create_social_post",[319,725,726],{},[233,727,333],{},[319,729,730],{},"Schedule a post (or save a draft) on a platform. Supports text posts, threads, links, titles, subreddits, media by URL or content-library ID, and Instagram\u002FFacebook media types.",[304,732,733,738,742],{},[319,734,735],{},[233,736,737],{},"postpone_delete_social_posts",[319,739,740],{},[233,741,333],{},[319,743,744],{},"Delete one or more scheduled posts. Cannot delete already-published posts. Results are reported per post.",[304,746,747,751,755],{},[319,748,749],{},[233,750,650],{},[319,752,753],{},[233,754,353],{},[319,756,757],{},"Search your content library for media (images, GIFs, and videos) and return IDs to attach to posts.",[206,759,760],{"type":377},[194,761,762,249,764,766],{},[233,763,723],{},[233,765,737],{}," change real content on your behalf. A well-behaved client will show you the exact content and ask for explicit confirmation before calling them.",[218,768,28],{"id":769},"rate-limits",[194,771,772,773,776,777,780],{},"MCP tool calls share the same budget as the GraphQL API — ",[213,774,775],{},"25 requests per 10 minutes"," on free accounts and ",[213,778,779],{},"300 requests per 10 minutes"," on paid accounts.",[194,782,783,784,787,788,791,792,795,796,799,800,803],{},"When you exceed the limit, the server returns a ",[233,785,786],{},"429"," with ",[233,789,790],{},"X-RateLimit-Limit",", ",[233,793,794],{},"X-RateLimit-Remaining",", and ",[233,797,798],{},"X-RateLimit-Reset"," headers. See the ",[198,801,802],{"href":29},"Rate Limits guide"," for details.",[218,805,807],{"id":806},"setup-guides","Setup Guides",[194,809,810,811,816],{},"Step-by-step instructions for individual clients live in your Postpone account under ",[198,812,814],{"href":418,"rel":813},[202],[213,815,422],{},", with dedicated guides for Claude, ChatGPT, Perplexity, Grok, Zapier, n8n, Raycast, Cursor, and any other MCP client.",[818,819,820],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":235,"searchDepth":471,"depth":478,"links":822},[823,824,828,829,830],{"id":220,"depth":478,"text":221},{"id":269,"depth":478,"text":13,"children":825},[826,827],{"id":284,"depth":497,"text":285},{"id":370,"depth":497,"text":371},{"id":631,"depth":478,"text":632},{"id":769,"depth":478,"text":28},{"id":806,"depth":478,"text":807},"Connect AI agents to Postpone with the Model Context Protocol (MCP) server, using OAuth or a Bearer token.","md",null,{},{"icon":36},{"title":33,"description":831},{"loc":34},"IdXmfpJxriy6tCIEjwhrA8vSrQgHHN8kc6jqWk6tXkw",[840,842],{"title":28,"path":29,"stem":30,"description":841,"icon":31,"children":-1},"Understand Postpone's API rate limits and how to handle them in your applications.",{"title":44,"path":45,"stem":46,"description":843,"icon":47,"children":-1},"Query the authenticated user's profile, account details, and plan information.",1782839144541]