# MCP tools

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

The 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? | `find_accounts_needing_attention`, then `schedule_post`. |
| 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. |

## Accounts

| Tool | What it does | Changes things? |
|---|---|---|
| [`find_accounts_needing_attention`](https://docs.flung.dev/reference/mcp/find-accounts-needing-attention.md) | Find accounts that need a person | Reads only |
| [`list_accounts`](https://docs.flung.dev/reference/mcp/list-accounts.md) | List connected accounts | Reads only |
| [`get_account`](https://docs.flung.dev/reference/mcp/get-account.md) | Get an account | Reads only |
| [`connect_account`](https://docs.flung.dev/reference/mcp/connect-account.md) | Connect a new account | Changes something |
| [`reconnect_account`](https://docs.flung.dev/reference/mcp/reconnect-account.md) | Reconnect an account | Changes something |
| [`get_connect_session`](https://docs.flung.dev/reference/mcp/get-connect-session.md) | Check a connect session | Reads only |
| [`refresh_account`](https://docs.flung.dev/reference/mcp/refresh-account.md) | Refresh an account now | Changes something; safe to repeat |
| [`disconnect_account`](https://docs.flung.dev/reference/mcp/disconnect-account.md) | Disconnect an account | Changes or removes something |
| [`get_posting_options`](https://docs.flung.dev/reference/mcp/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/reference/mcp/schedule-post.md) | Schedule a post | Changes something |
| [`update_post`](https://docs.flung.dev/reference/mcp/update-post.md) | Change a scheduled post | Changes something; safe to repeat |
| [`cancel_post`](https://docs.flung.dev/reference/mcp/cancel-post.md) | Cancel a scheduled post | Changes or removes something |
| [`retry_post`](https://docs.flung.dev/reference/mcp/retry-post.md) | Retry a post's failed accounts | Changes something |
| [`import_media`](https://docs.flung.dev/reference/mcp/import-media.md) | Add an image or video from a URL | Changes something |
| [`get_post`](https://docs.flung.dev/reference/mcp/get-post.md) | Get a post | Reads only |
| [`list_posts`](https://docs.flung.dev/reference/mcp/list-posts.md) | List posts | Reads only |
| [`get_post_metrics`](https://docs.flung.dev/reference/mcp/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/reference/mcp/list-platforms.md) | List platforms and their limits | Reads only |
| [`suggest_posting_times`](https://docs.flung.dev/reference/mcp/suggest-posting-times.md) | Suggest when to post | Reads only |

## Inbox

| Tool | What it does | Changes things? |
|---|---|---|
| [`list_inbox`](https://docs.flung.dev/reference/mcp/list-inbox.md) | List comments and mentions | Reads only |
| [`reply_to_inbox_item`](https://docs.flung.dev/reference/mcp/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/reference/mcp/list-templates.md) | List post templates | Reads only |
| [`deploy_template`](https://docs.flung.dev/reference/mcp/deploy-template.md) | Schedule a post from a template | Changes something |
| [`list_variables`](https://docs.flung.dev/reference/mcp/list-variables.md) | List workspace variables | Reads only |
| [`set_variable`](https://docs.flung.dev/reference/mcp/set-variable.md) | Set a workspace variable | Changes something; safe to repeat |
| [`list_feeds`](https://docs.flung.dev/reference/mcp/list-feeds.md) | List RSS feeds | Reads only |
| [`follow_feed`](https://docs.flung.dev/reference/mcp/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/reference/mcp/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 |