# MCP tools

> Page: https://docs.flung.dev/mcp/tools. Index of every page: https://docs.flung.dev/llms.txt

The 6 workflows and 28 tools Flung's MCP server gives an AI agent: connect and reconnect social accounts, schedule and retry posts, read and answer comments, and automate posting.

## TL;DR

| Question | Answer |
|---|---|
| Where is the server? | `https://mcp.flung.dev/mcp-oauth` signs a person in through their browser; `https://mcp.flung.dev/mcp` takes an API key. Both speak Streamable HTTP. |
| Where do I start? | With a workflow: each does the work of several tools in one call. `review_workspace` says what needs doing. |
| Workflow or tool? | A workflow for a whole job, such as posting to several platforms; a single tool for one exact step, or when a workflow's choices are not the ones wanted. |
| Can an agent connect an account alone? | No. A connect returns the platform's consent link; a person opens it and approves. |
| Is there a machine-readable list? | `https://docs.flung.dev/tools.json` has every tool with its JSON Schema. |

## Workflows

| Workflow | What it does | Calls | Changes things? |
|---|---|---|---|
| [`review_workspace`](https://docs.flung.dev/mcp/workflows/review-workspace.md) | Review the workspace | `find_accounts_needing_attention`, `list_posts`, `list_inbox` | Reads only |
| [`reconnect_accounts_needing_attention`](https://docs.flung.dev/mcp/workflows/reconnect-accounts-needing-attention.md) | Get reconnect links for every account that needs one | `find_accounts_needing_attention`, `reconnect_account` | Changes something |
| [`connect_platforms`](https://docs.flung.dev/mcp/workflows/connect-platforms.md) | Start connecting several platforms | `list_platforms`, `connect_account` | Changes something |
| [`publish_to_platforms`](https://docs.flung.dev/mcp/workflows/publish-to-platforms.md) | Post to platforms by name | `list_accounts`, `list_platforms`, `import_media`, `suggest_posting_times`, `schedule_post` | Changes something |
| [`retry_failed_posts`](https://docs.flung.dev/mcp/workflows/retry-failed-posts.md) | Retry failed posts whose accounts work | `find_accounts_needing_attention`, `list_posts`, `get_post`, `retry_post` | Changes something |
| [`report_post_performance`](https://docs.flung.dev/mcp/workflows/report-post-performance.md) | Report how recent posts did | `list_posts`, `get_post_metrics` | Reads only |

## Accounts

| Tool | What it does | Changes things? |
|---|---|---|
| [`find_accounts_needing_attention`](https://docs.flung.dev/mcp/tools/find-accounts-needing-attention.md) | Find accounts that need a person | Reads only |
| [`list_accounts`](https://docs.flung.dev/mcp/tools/list-accounts.md) | List connected accounts | Reads only |
| [`get_account`](https://docs.flung.dev/mcp/tools/get-account.md) | Get an account | Reads only |
| [`connect_account`](https://docs.flung.dev/mcp/tools/connect-account.md) | Connect a new account | Changes something |
| [`reconnect_account`](https://docs.flung.dev/mcp/tools/reconnect-account.md) | Reconnect an account | Changes something |
| [`get_connect_session`](https://docs.flung.dev/mcp/tools/get-connect-session.md) | Check a connect session | Reads only |
| [`refresh_account`](https://docs.flung.dev/mcp/tools/refresh-account.md) | Refresh an account now | Changes something; safe to repeat |
| [`disconnect_account`](https://docs.flung.dev/mcp/tools/disconnect-account.md) | Disconnect an account | Changes or removes something |
| [`get_posting_options`](https://docs.flung.dev/mcp/tools/get-posting-options.md) | Read a TikTok account's posting options | Reads only |

## Posts and media

| Tool | What it does | Changes things? |
|---|---|---|
| [`schedule_post`](https://docs.flung.dev/mcp/tools/schedule-post.md) | Schedule a post | Changes something |
| [`update_post`](https://docs.flung.dev/mcp/tools/update-post.md) | Change a scheduled post | Changes something; safe to repeat |
| [`cancel_post`](https://docs.flung.dev/mcp/tools/cancel-post.md) | Cancel a scheduled post | Changes or removes something |
| [`retry_post`](https://docs.flung.dev/mcp/tools/retry-post.md) | Retry a post's failed accounts | Changes something |
| [`import_media`](https://docs.flung.dev/mcp/tools/import-media.md) | Add an image or video from a URL | Changes something |
| [`get_post`](https://docs.flung.dev/mcp/tools/get-post.md) | Get a post | Reads only |
| [`list_posts`](https://docs.flung.dev/mcp/tools/list-posts.md) | List posts | Reads only |
| [`get_post_metrics`](https://docs.flung.dev/mcp/tools/get-post-metrics.md) | Read a post's views and likes | Reads only |

## Planning

| Tool | What it does | Changes things? |
|---|---|---|
| [`list_platforms`](https://docs.flung.dev/mcp/tools/list-platforms.md) | List platforms and their limits | Reads only |
| [`suggest_posting_times`](https://docs.flung.dev/mcp/tools/suggest-posting-times.md) | Suggest when to post | Reads only |

## Inbox

| Tool | What it does | Changes things? |
|---|---|---|
| [`list_inbox`](https://docs.flung.dev/mcp/tools/list-inbox.md) | List comments and mentions | Reads only |
| [`reply_to_inbox_item`](https://docs.flung.dev/mcp/tools/reply-to-inbox-item.md) | Reply to a comment or mention | Changes something |

## Automation

| Tool | What it does | Changes things? |
|---|---|---|
| [`list_templates`](https://docs.flung.dev/mcp/tools/list-templates.md) | List post templates | Reads only |
| [`deploy_template`](https://docs.flung.dev/mcp/tools/deploy-template.md) | Schedule a post from a template | Changes something |
| [`list_variables`](https://docs.flung.dev/mcp/tools/list-variables.md) | List workspace variables | Reads only |
| [`set_variable`](https://docs.flung.dev/mcp/tools/set-variable.md) | Set a workspace variable | Changes something; safe to repeat |
| [`list_feeds`](https://docs.flung.dev/mcp/tools/list-feeds.md) | List RSS feeds | Reads only |
| [`follow_feed`](https://docs.flung.dev/mcp/tools/follow-feed.md) | Post new items from an RSS feed | Changes something |

## Workspace

| Tool | What it does | Changes things? |
|---|---|---|
| [`get_experience`](https://docs.flung.dev/mcp/tools/get-experience.md) | Read XP, level and achievements | Reads only |

## See also

| Doc | Why |
|---|---|
| [Connect an AI agent](https://docs.flung.dev/mcp.md) | Install the server in Claude Code, Cursor, VS Code or Claude Desktop |
| [Prompts and recipes](https://docs.flung.dev/agents/prompts.md) | What to ask, and the tools an agent calls for it |
| [API reference](https://docs.flung.dev/reference/api.md) | The same operations over HTTP |