MCP Tool Reference

All 15 tools exposed by the Pharlo MCP server, organized by domain.

Assignments

Assignments are publishing jobs. Each one moves through a lifecycle: pending → uploading → uploaded → processing → published (or failed / cancelled).

See Workflows for end-to-end prompt patterns, and Assignments REST reference for the underlying API.

create_assignment

Create a new publishing job to post content to a social media platform.

readOnly: false | destructive: true | idempotent: false | openWorld: true

Example prompts:

"Upload https://cdn.example.com/demo.mp4 (opens in a new tab) to my YouTube channel 'Tech Reviews'. Title: 'Product Demo v3', make it public, schedule for Friday at 6 PM Berlin time."

"Post this video to my Facebook page as public. Description: 'Check out our new feature'. Use https://cdn.example.com/promo.mp4 (opens in a new tab)"

Example payload — YouTube video:

{
  "connectionId": "7f3e1a2b-4c5d-6e7f-8a9b-0c1d2e3f4a5b",
  "type": "video",
  "mediaUrl": "https://cdn.example.com/demo.mp4",
  "mediaContentType": "video/mp4",
  "scheduledAt": "2026-04-25T18:00:00+02:00",
  "payload": "{\"title\":\"Product Demo v3\",\"description\":\"See what's new\",\"privacy\":\"public\",\"tags\":[\"demo\",\"product\"]}"
}

Example payload — Facebook post:

{
  "connectionId": "9a8b7c6d-5e4f-3210-fedc-ba9876543210",
  "type": "video",
  "mediaUrl": "https://cdn.example.com/promo.mp4",
  "payload": "{\"description\":\"Check out our new feature!\",\"privacy\":\"EVERYONE\"}"
}

Programmatic usage (custom agents):

import anthropic
 
client = anthropic.Anthropic()
 
response = client.beta.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    betas=["mcp-client-2025-04-04"],
    mcp_servers=[
        {
            "type": "url",
            "url": "https://pharlo.io/_mcp",
            "authorization_token": "mcp_at_your_token",
        }
    ],
    messages=[
        {
            "role": "user",
            "content": (
                "Upload https://cdn.example.com/demo.mp4 to my YouTube channel "
                "'Tech Reviews'. Title: 'Product Demo v3', public, "
                "schedule for 2026-04-25T18:00:00+02:00."
            ),
        }
    ],
)
 
for block in response.content:
    if hasattr(block, "text"):
        print(block.text)

list_assignments

List publishing assignments with optional filters and pagination.

readOnly: true | destructive: false | idempotent: true | openWorld: false

Example prompts:

"Show me my last 10 assignments."

"List all failed assignments from the past week on my YouTube channel."

"What assignments are currently pending or processing?"

get_assignment

Get full details of a specific assignment including status, errors, platform URL, and payload.

readOnly: true | destructive: false | idempotent: true | openWorld: false

Example prompt:

"What's the status of assignment a1b2c3d4-e5f6-7890-abcd-ef1234567890? Did it publish?"

Example response fields:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "published",
  "platform": "youtube",
  "type": "video",
  "platformUrl": "https://youtu.be/dQw4w9WgXcQ",
  "publishedAt": "2026-04-25T16:02:00Z",
  "scheduledAt": "2026-04-25T16:00:00Z",
  "payload": { "title": "Product Demo v3", "privacy": "public" }
}

update_assignment

Update a pending or uploaded assignment's scheduled time or payload before it is published.

readOnly: false | destructive: true | idempotent: false | openWorld: false

Example prompts:

"Reschedule assignment a1b2c3d4 to Monday at 9 AM Kyiv time."

"Change the title of my pending assignment a1b2c3d4 to 'Q2 Launch'."

retry_assignment

Retry a failed assignment. Re-queues it without creating a new assignment.

readOnly: false | destructive: false | idempotent: true | openWorld: true

Example prompt:

"Retry my failed assignment a1b2c3d4."

"List all failed assignments from today and retry them."

cancel_assignment

Cancel a pending or scheduled assignment.

readOnly: false | destructive: true | idempotent: false | openWorld: false

Example prompt:

"Cancel assignment a1b2c3d4 — I need to update the video first."

Connections

A connection represents an authorized social media channel (YouTube channel, Facebook page). You need a connectionId before you can create assignments.

See Connections REST reference for the underlying API.

list_connections

List all authorized channels.

readOnly: true | destructive: false | idempotent: true | openWorld: false

Example prompts:

"List all my connected YouTube channels."

"Show me all my social media connections including inactive ones."

get_connection

Get details for a specific connection: token status, channel metadata, and configuration.

readOnly: true | destructive: false | idempotent: true | openWorld: false

Example prompt:

"Show me the details and token status of my 'Tech Reviews' YouTube channel."

update_connection

Update a connection's display name or active status.

readOnly: false | destructive: false | idempotent: true | openWorld: false

Example prompts:

"Rename my YouTube connection a1b2c3d4 to 'Main Channel'."

"Deactivate the Facebook page connection 9a8b7c6d — we're pausing that account."

Analytics

Live analytics tools that query the platform API in real time (YouTube Data API, Meta Graph API). Each call counts against both your Pharlo bill and the platform's own quota.

See Analytics REST reference for the underlying API.

get_channel_stats

Live channel-level metrics for a connection: subscribers, total views, total posts.

readOnly: true | destructive: false | idempotent: true | openWorld: true

Example prompts:

"How many subscribers does my 'Tech Reviews' channel have right now?"

"Show me the current view count and post count for all my YouTube channels."

get_post_stats

Live performance metrics for a single published post: views, likes, comments, shares.

readOnly: true | destructive: false | idempotent: true | openWorld: true

Example prompts:

"How is my latest video performing?"

"Get the current view and like count for post a1b2c3d4 on my 'Tech Reviews' channel."

OAuth

Authorize a new social channel (YouTube or Meta) for publishing.

See OAuth REST reference for the underlying API.

get_oauth_connect_url

Generate an OAuth consent URL to connect a new channel or re-authorize an existing one.

readOnly: false | destructive: false | idempotent: false | openWorld: true

Response includes: url, ticketId, expiresIn, platform, instructions

Example prompts:

"I want to connect my second YouTube channel to Pharlo."

"My YouTube token has expired — re-authorize my 'Tech Reviews' channel."

Platforms

Platform capabilities describe what each social network supports: content types, payload fields, character limits, allowed values, and file size constraints. Always check capabilities before creating assignments.

See Platform Capabilities REST reference for the underlying API.

list_platforms

List all supported platforms with slugs, display names, and supported content types.

readOnly: true | destructive: false | idempotent: true | openWorld: false

No parameters.

Example prompt:

"What platforms does Pharlo support?"

Example response:

[
  { "slug": "youtube", "name": "YouTube", "hasCapabilities": true, "contentTypes": ["video", "short"] },
  { "slug": "facebook", "name": "Facebook", "hasCapabilities": true, "contentTypes": ["video", "image", "link", "text", "reel", "story"] }
]

get_platform_capabilities

Get detailed capabilities for a platform: content types, file size limits, payload fields with types, defaults, and constraints.

readOnly: true | destructive: false | idempotent: true | openWorld: false

Example prompt:

"What payload fields does YouTube support for video assignments?"

Example response (abbreviated):

{
  "platform": "youtube",
  "contentTypes": {
    "video": {
      "payloadSchema": {
        "title":       { "type": "string", "required": true, "maxLength": 100 },
        "description": { "type": "string", "maxLength": 5000 },
        "privacy":     { "type": "enum", "values": ["public", "unlisted", "private"], "default": "private" },
        "tags":        { "type": "array", "items": "string", "maxItems": 500 }
      },
      "mediaConstraints": {
        "maxSizeBytes": 137438953472,
        "allowedMimeTypes": ["video/mp4", "video/quicktime", "video/x-msvideo"]
      }
    }
  }
}

Webhooks

Webhooks deliver real-time status change notifications to your server. See Webhooks guide and Webhooks REST reference for setup details.

list_webhook_deliveries

List recent webhook delivery attempts with HTTP response codes and error details.

readOnly: true | destructive: false | idempotent: true | openWorld: false

Example prompts:

"Show me recent webhook delivery failures."

"Were all webhooks delivered successfully today?"