Mr Farts Developer Docs

Last updated: 9 October 2026 · Publisher: HUGO FM GAMES (hugo.fm)

Overview

Fart Sounds is an MCP server that plays Mr Farts fart sounds, songs and cartoons inside AI assistants. Playback tools open an embedded player (an MCP Apps interface) that plays the audio or video in the chat.

• Free. Every sound, song and cartoon is free. No tool takes payment.
• No account. There is no sign-in, OAuth or API key.
• Catalogue: 145 fart sounds, 30 animal farts, seasonal packs (Christmas 22, Easter 11, Halloween 8, Valentine's Day 11), 61 Mr Farts songs and 10 cartoons.
• Languages: result text in English, German, French and Spanish.
• Media: all audio and video are pre-recorded MP3 and MP4 files on https://assets.mrfarts.tv. The server does not generate audio or video.

Mr Farts started as Big Fart, an Alexa skill.

Connect

ChatGPT

In ChatGPT developer mode, add a custom app with the server address https://fart.shoutoutgames.com/mcp and no authentication. Then ask for a fart and tap Enable sound in the player.

Claude

1. In Claude, open Customize > Connectors.
2. Choose Add custom connector.
3. Enter the URL exactly: https://claude.mrfarts.io/mcp
4. For authentication, choose No sign-in.
5. Ask for a fart, then tap Enable sound in the player.

Any MCP client

curl -s https://fart.shoutoutgames.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

How the two addresses differ

Both addresses serve the same 13 tools, the same inputs and the same structuredContent. They differ in presentation, in the player address (mcpUrl) and in the player domain Claude needs. Claude connectors that still use /mcp get the Claude presentation too.

Tools

The model can call 9 tools. Read means the tool changes nothing. Write means the tool changes only our own anonymous player session. No tool reads or changes user accounts, sends messages, publishes anything or spends money. No tool is a sensitive write.

Inputs

Every input is optional. Input objects are strict: an unknown property is rejected with an input validation error.

If locale or timezone is missing, the server uses the hints the host sends (ChatGPT sends openai/locale and openai/userLocation), then the session's saved values, then en-US and UTC.

Outputs

• content: one text item. On /mcp it names what is playing and adds a suggestion, for example Here comes Wet fart! Try: "Play a wet fart!". The suggestion is picked at random.
• structuredContent: text, revision, locale, timezone, playbackStatus, needsPlayer and suggestion. When relevant it also has selection (id, title, category, audioUrl, videoUrl), command (what the player should do, including the full playlist), and, for browse_farts, items and total.
• _meta: sessionId, widgetToken and mcpUrl, for the player. Every model-facing tool except browse_farts returns it.

Tool annotations: readOnlyHint is true only for browse_farts. openWorldHint is false for every tool. destructiveHint is true only for control_player (see below).

Player-only tools

Four more tools exist only for the embedded player. Each one declares _meta.ui.visibility: ["app"], so hosts that render MCP Apps hide them from the model. The model never needs them. A host that does not render the player has no reason to call them.

These tools need credentials from a previous result. show_player and every playback tool return sessionId, widgetToken and mcpUrl in _meta. control_player and player_request go through the host and need only sessionId. sync_player and acknowledge_playback go straight from the player to mcpUrl and also need widgetToken. Called with made-up values, they return the session-expired error.

Repeating a control_player or player_request call with the same operationId does not repeat the command. The result has duplicate: true.

Player sessions

Each player works in an anonymous session that is deleted 24 hours after it was last used. In ChatGPT, one conversation keeps one session. Claude sends no conversation identifier, so each Claude request starts a new session, and an open player switches to the newest one.

Example request and response

Request:

POST https://fart.shoutoutgames.com/mcp
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fart","arguments":{"selection":"wet"}}}

Response from /mcp (shortened). Clients that accept text/event-stream receive the same JSON as a single SSE event (event: message / data: …).

{
  "jsonrpc": "2.0", "id": 1,
  "result": {
    "content": [{ "type": "text", "text": "Here comes Wet fart! Try: \"Play a wet fart!\"" }],
    "structuredContent": {
      "text": "Here comes Wet fart!",
      "selection": {
        "id": "sounds:24", "category": "sounds", "title": "Wet",
        "audioUrl": "https://assets.mrfarts.tv/farts/24.mp3",
        "videoUrl": "https://assets.mrfarts.tv/short-vid-farts/24.mp4"
      },
      "playbackStatus": "requested"
    },
    "_meta": { "sessionId": "…", "widgetToken": "…", "mcpUrl": "https://fart.shoutoutgames.com/mcp" }
  }
}

On claude.mrfarts.io/mcp, the same call returns the same structuredContent. The text adds the media link, and mcpUrl is https://claude.mrfarts.io/mcp:

Here comes Wet fart! Media: https://claude.mrfarts.io/media/farts/24.mp3 Try: "Play a wet fart!"

A browse_farts call with {"query":"wet","limit":3} on claude.mrfarts.io/mcp returns text like this:

4 matching items. All packs are free.
sounds:24: Wet
sounds:23: Wet and Squeaky
sounds:59: Wet and Grumpy
Try: "Play a Mr Farts cartoon!"

Example prompts

Errors and limits

Tool errors

Tool errors come back as a normal result with isError: true and a text message.

Unknown sound, song or cartoon names are not errors. A random item from that pack plays, and the result names what played.

HTTP status codes

Limits

• Rate limit: 15 requests per second per client IP address, with a burst of 30, on each endpoint. Over that, the server returns HTTP 429. Our server sits behind Cloudflare and currently sees Cloudflare's address, not yours, so requests that arrive through the same Cloudflare edge share one limit.
• Request size: 100 KB.
• Inputs: count 1–100, seconds 1–1800, limit 1–100, offset 0–1000.
• Sessions: deleted 24 hours after last use.

Troubleshooting

• No sound. Browsers block autoplay until you interact with the page. Tap Enable sound in the player. Each new player in the chat may need its own tap.
• "Audio is unavailable. Tap the player to retry." Tap the player.
• Nothing loads or plays. Audio and video come from https://assets.mrfarts.tv. Check that an ad blocker, firewall or network filter is not blocking that domain.
• Video does not play. The player falls back to the audio when it has an audio file. You can turn video off with the player's Video switch.
• No player appears. The host does not render MCP Apps. The result still names what was chosen. On claude.mrfarts.io/mcp the text includes direct media links, and on both addresses structuredContent carries the media URLs.
• "This player session expired." Ask again. A new player opens with a new session.
• Several players in one chat. Players that share a session (in ChatGPT, every player in the conversation) play one at a time. Pressing a button in a player makes it the active one.
• The player stops updating. It pauses while its tab is hidden and resumes when you come back.

Data and privacy

• Received per call: the item you asked for, your language and timezone, and, for a name fart, the first name you typed. We receive the tool call only, not your conversation. ChatGPT also sends anonymous conversation and user identifiers, and may send a general location hint; the server reads only the timezone from it and does not store the identifiers.
• Stored: an anonymous player session with the last command (including any first name typed for a name fart), language and timezone. It is deleted 24 hours after last use. In ChatGPT, the session reference is a keyed hash of ChatGPT's anonymous conversation and user identifiers. In Claude, each request gets a new random session.
• Logs: our app logs record each request's status and duration only. Web server access logs (IP address, time, the address requested and client details) rotate daily and are kept for about 14 days.
• Hosting: the server runs on DigitalOcean behind Cloudflare. Media is served from assets.mrfarts.tv through Cloudflare.
• Not collected: accounts, email, location, contacts, payment details, microphone or camera. No advertising or analytics cookies. We do not sell your data.

Full details: Privacy policy.

Support

Questions, bug reports and deletion requests: hugo.fm/contact.

Fart Sounds and Mr Farts are published by HUGO FM GAMES, a trading name of HUGO.FM Games Limited (company no. 14615936) (hugo.fm). Terms of use.