> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postinger.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP examples

> Practical prompts and tool calls for common tasks.

## Create an image draft

> List my accounts and check the chosen account's publishing rules. Import the image at my public HTTPS URL, then create a draft with the caption “A new update”. Show me the draft and wait for my publishing instruction.

The assistant should call `list_accounts`, `get_publishing_capabilities`, `upload_media`, then `create_draft`.

```json theme={null}
{
  "draft": {
    "content": "A new update",
    "targets": [{ "socialAccountId": "11111111-1111-4111-8111-111111111111" }],
    "mediaIds": ["22222222-2222-4222-8222-222222222222"]
  },
  "idempotencyKey": "image-draft-001"
}
```

Replace the example UUIDs with IDs returned by your project. A URL must point directly to an accessible HTTPS media file. Uploading does not publish.

## Schedule an existing draft

> Schedule this draft for December 1, 2026 at 10:00 in Istanbul. Keep the existing caption, targets, and media.

The corresponding `update_post` input is:

```json theme={null}
{
  "postId": "33333333-3333-4333-8333-333333333333",
  "patch": { "scheduledAt": "2026-12-01T10:00:00+03:00" }
}
```

Choose a future timestamp. `schedule_post` would create another post, so use `update_post` for an existing draft.

## Read a report

> Show stored analytics for September 1–30, 2026. Check which platforms and metrics are available, and explain any missing or partial data.

The assistant should check `get_analytics_capabilities`, then call `get_analytics_report` with `from` and `to`. Analytics tools read existing measurements; they do not trigger a new collection.

## Publish and inspect

> Publish the draft I approved, then check each target and tell me whether it has actually published.

The assistant calls `publish_post` with a stable idempotency key, then `get_post`. The returned target count means queued targets, not completed publications.


## Related topics

- [Build with Postinger](/introduction.md)
- [Connect with MCP](/mcp/quickstart.md)
- [Publish a post](/guides/publishing.md)
- [Local MCP server](/mcp/local-server.md)
- [MCP tool reference](/mcp/tools.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.