Skip to content
HomeDocsPricing
Sign in

Docs

Add one URL to your MCP client, sign in, and your agent gets these tools. Each platform's own API reference still applies.

Add the server

Postparrot speaks MCP over Streamable HTTP and signs you in with OAuth. Add the URL to your client. The first call opens a page where you choose the accounts this agent may use.

Config file
{
  "mcpServers": {
    "postparrot": {
      "type": "http",
      "url": "https://postparrot.app/mcp"
    }
  }
}

Tools

list_accounts
The accounts this agent may use, with their ids and whether each one is read only or full access. Call it first.
youtube_request, tiktok_request, instagram_request, facebook_request
The platform's API as it is. Send { account, method, path, query?, body?, media? } the way the platform documents the call. Postparrot adds the token and removes tokens from the answer.
upload_media
A one use upload link and a public URL for a video or image. The file is kept 48 hours, then deleted.
tiktok_publish
Prepares a TikTok post and returns a page link. The post is sent only after the account's owner confirms it on that page.
tiktok_approval
The state of a prepared TikTok post: waiting, posting, sent, failed or declined.

Endpoint lists

Each platform's allowed endpoints are a resource of the server, so your agent can read them before it calls anything. Reading them is free.

  • YouTubepostparrot://docs/youtube
  • TikTokpostparrot://docs/tiktok
  • Instagrampostparrot://docs/instagram
  • Facebookpostparrot://docs/facebook

Read only and full access

Read only

Only endpoints that read: posts, comments and numbers. A call that would change anything is refused before it reaches the platform.

Full access

Reading, plus posting, replying, editing and deleting. Endpoints that hand out tokens or reach other people's accounts are never open.

Limits today

Each platform reviews apps like Postparrot before it lifts its limits. Until then:

  • YouTube keeps uploads private until YouTube finishes its review of Postparrot.
  • TikTok shows posts only to the creator until TikTok finishes its review.
  • Instagram and Facebook work only for accounts added as testers until Meta finishes its review.
  • Reading numbers and comments on YouTube and TikTok is not limited.

Requests

One tool call is one request. Listing tools and reading resources are free. 10,000 requests a month are free. A call past your limit returns an error that says so, and nothing is sent to the platform. See pricing.