Tools reference

Tools reference

The 17 tools of the Tipsterland MCP: what each one does, what data it uses, how to add an image and example prompts.

These are the 17 tools your assistant can use. You don't need to learn their names: just ask for what you want in your own words and it picks the tool and fills in the data. The names help you understand what it's doing, or ask for a specific one.

Your account

mi_cuenta

Your plan, your basic stats and how much you have left today of each limit. Read-only.

Try saying
  • “Which Tipsterland plan am I on?”
  • “How many more picks can I create today?”

Picks

listar_mis_picks

Your picks, with filters: pending, won, lost, void… Handy before setting results.

Try saying
  • “List my pending picks.”
  • “Which picks did I lose last week?”
  • “Show me my last 10 tennis picks.”

ver_pick

The full details of one pick.

Try saying
  • “Show me the details of yesterday's Madrid pick.”
  • “What odds did I post pick 48213 at?”

crear_pick

Posts a pick. Main data: event, selection, odds (1.01 to 1,000) and stake (0.01 to 10); optionally also sport, competition, bookmaker, match date, whether it's live or an accumulator, your reasoning and one image (for example, your bet slip; see Images). It can be:

  • free (shows in the feed),
  • channel (only that channel's subscribers see it),
  • paid (with a price; optionally with a time after which it becomes free),
  • channel and also sold on its own: it reaches your paid channel as usual and is also sold individually to anyone who isn't subscribed (tambien_suelto, with a price and, optionally, fin_de_venta; by default the sale runs until the event starts),
  • and scheduled: it goes out on its own at the time you say.
Try saying
  • “Post a free pick: Atlético v Getafe, Atlético to win, odds 1.65, stake 4, on Bet365.”
  • “Create a pick in my VIP channel: Djokovic wins the first set, odds 1.90, stake 3. Schedule it for tomorrow at 9:00.”
  • “Paid pick at €9.95: over 9.5 corners in Sevilla v Valencia, odds 1.95, stake 2. Make it free when the match kicks off.”
  • “Post Betis v Celta in my VIP channel, Betis to win at 2.10, stake 3, and also sell it on its own for €9.95 until kick-off.”

marcar_resultado

Sets a pick's result: won, lost, void or pending (to put it back to pending if you set it by mistake). Data: the pick and the result. It's the only thing you can change on a published pick: it doesn't touch the odds, the stake or the text.

Try saying
  • “The Betis pick won.”
  • “Mark the Nadal pick as void, he retired.”
  • “Mark all of yesterday's pending picks that came in as won.”

cerrar_venta

Closes the sale of one of your paid picks that is still on sale: it can no longer be bought right away and everyone can see it in full, labelled «Paid pick». People who already bought it lose the exclusivity. Data: the pick. It can't be undone, so your assistant will ask you to confirm first. You still mark the result as usual, with marcar_resultado. It doesn't work on a pick that's already settled, whose sale has already closed (the event started or its end of sale passed) or that isn't paid. It's the same as Close sale on the pick itself, on the website or the app, and it doesn't count towards your new-picks limit.

Try saying
  • “Close the sale of the Betis pick: the odds have changed and I want everyone to see it.”
  • “Take this afternoon's paid pick off sale and make it public.”

recalcular_como_ganado

Asks to recalculate a pending pick as won when it won at odds other than the published ones: half won (half the bet won, half refunded) or won at different odds (the bookmaker changed them). Data: the pick and the final odds, greater than 1 and different from the published odds. For a half win, the final odds are (1 + published odds) / 2: published at 1.90, that's 1.45.

Try saying
  • “The Betis pick was a half win (Asian handicap -0.25).”
  • “The Djokovic pick won, but the bookmaker paid it at 1.75 instead of 1.90.”

recalcular_como_perdido

Asks to recalculate a pending pick as lost when only part of the stake was lost: half lost (half the bet lost, half refunded) or another partial loss. Data: the pick and the stake lost, greater than 0 and less than the pick's stake. For a half loss it's half the stake. If you lost the whole stake, it's a normal loss: use marcar_resultado.

Try saying
  • “The Sevilla pick was a half loss (Asian handicap +0.25): stake 2, I lost 1.”

Channels and posts

listar_mis_canales

Your channels, with their subscriber counts. Read-only.

Try saying
  • “How many subscribers does each of my channels have?”

publicar_en_canal

Posts a text message (up to 4,000 characters, with formatting) to one of your channels, with one image if you like, right away or scheduled. Your subscribers are notified like with any other message. Paused channels can't be posted to.

Try saying
  • “Post in my channel: “Morning all, 3 football picks today from 5 pm”.”
  • “Schedule for Saturday at 10:00 in my VIP channel: “Weekly recap: +12.4 units”.”
  • “Post in my channel “That's a wrap for the week” with this image: https://my-site.com/recap.png”

crear_post

Posts to the feed, with text and, if you like, an image or a quote of one of your picks.

Try saying
  • “Write a post saying we're on a 7-win streak.”
  • “Post quoting my Clásico pick with my analysis.”

Images

crear_pick, crear_post and publicar_en_canal accept one image: your bet slip, a screenshot, a chart…

RequirementDetails
FormatsJPEG, PNG, WebP and GIF. HEIC (iPhone photos) isn't accepted: convert it to JPEG first (on iPhone, Settings → Camera → Formats → Most Compatible).
Maximum size10 MB
How manyOne per pick, post or message
Not acceptedVideo, PDF, SVG or HEIC

How you give it the image depends on your assistant:

AssistantHow to give it the image
ChatGPTAttach the photo to your message, like any image, and ask it to use it in the pick, post or message. ChatGPT passes it on to Tipsterland. A link works too.
Claude (claude.ai and its apps)Claude doesn't pass chat attachments to connectors: it can see the photo you upload, but it can't send it to Tipsterland. Give it an https:// link that leads straight to the image (imagen_url) or, if your assistant can read the file, have it send it as base64 (imagen_base64).
Claude Code, Cursor and other clients on your computerA link (imagen_url) or the file as base64 (imagen_base64): these clients can read it from your disk. Base64 makes sense for small images; otherwise, a link is better.

If you use a link, for it to work:

  • It must be public: it opens without signing in anywhere.
  • It must lead to the image, not a page: opened in a browser, you see just the image. “Share” links from Google Drive, Dropbox or iCloud usually open a preview page, and those won't work.
  • It must start with https://.
Try saying
  • “Post a free pick: Betis v Sevilla, Betis to win, odds 2.10, stake 3, with the slip photo: https://my-site.com/slip.jpg”
  • “Write a post with this chart of my month: https://my-site.com/september.png”
  • “(In ChatGPT, with the photo attached) Post the slip I've attached to my channel with the text “Saturday's accumulator”.”

If the image doesn't meet these conditions, Tipsterland rejects it and your assistant gets the reason. Each image counts towards its own limit.

Stats and earnings

mis_estadisticas

Yield, hit rate and profit by period. Read-only.

Try saying
  • “What's my yield this month?”
  • “Compare my hit rate in August and September.”

mis_ingresos

A summary of your earnings and payouts. Read-only.

Try saying
  • “How much have I earned this month?”
  • “When was my last payout?”

Discounts

listar_descuentos

Your discounts and promotions, active and inactive.

Try saying
  • “Which discounts do I have running?”

crear_descuento

Creates a discount for your subscriptions. Tipsterland's discount cap applies (50% at most): anything higher is rejected.

Try saying
  • “Create a 20% discount on my VIP channel for the weekend.”

desactivar_descuento

Turns off a discount you no longer want.

Try saying
  • “Turn off the weekend discount.”

Helper

Looks up the sport, competition and bookmaker IDs that crear_pick needs. Your assistant usually uses it on its own.

Try saying
  • “What's Serie A called in the Tipsterland catalogue?”

Summary

ToolWhat it doesChanges anything?
mi_cuentaPlan, basic stats and today's limitsNo
listar_mis_picksYour picks, with filtersNo
ver_pickOne pick's detailsNo
crear_pickPosts a pick (free, channel, paid or scheduled), optional imageYes
marcar_resultadoWon, lost, void or pendingYes · result only
cerrar_ventaTakes a paid pick off sale and opens it to everyoneYes · can't be undone
recalcular_como_ganadoHalf won or won at different oddsNo · sends a request
recalcular_como_perdidoHalf lost or partial lossNo · sends a request
listar_mis_canalesYour channels and subscribersNo
publicar_en_canalChannel message, now or scheduled, optional imageYes
crear_postFeed post, optional imageYes
mis_estadisticasYield, hit rate and profitNo
mis_ingresosEarnings and payoutsNo
listar_descuentosYour discountsNo
crear_descuentoCreates a discount (max 50%)Yes
desactivar_descuentoTurns off a discountYes
buscar_catalogoSports, competitions and bookmakersNo

No tool edits or deletes published content (cerrar_venta doesn't change the pick: it just stops selling it and opens it to everyone). Your app may ask you to approve each action that changes something (ChatGPT always does by default): that's your moment to check it. Each one counts towards the usage limits.

Stuck? Message us from the Tipsterland support chat.