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.
- “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.
- “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.
- “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.
- “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.
- “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.
- “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.
- “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.
- “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.
- “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.
- “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.
- “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…
| Requirement | Details |
|---|---|
| Formats | JPEG, PNG, WebP and GIF. HEIC (iPhone photos) isn't accepted: convert it to JPEG first (on iPhone, Settings → Camera → Formats → Most Compatible). |
| Maximum size | 10 MB |
| How many | One per pick, post or message |
| Not accepted | Video, PDF, SVG or HEIC |
How you give it the image depends on your assistant:
| Assistant | How to give it the image |
|---|---|
| ChatGPT | Attach 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 computer | A 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://.
- “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.
- “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.
- “How much have I earned this month?”
- “When was my last payout?”
Discounts
listar_descuentos
Your discounts and promotions, active and inactive.
- “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.
- “Create a 20% discount on my VIP channel for the weekend.”
desactivar_descuento
Turns off a discount you no longer want.
- “Turn off the weekend discount.”
Helper
buscar_catalogo
Looks up the sport, competition and bookmaker IDs that crear_pick needs. Your assistant usually uses it on its own.
- “What's Serie A called in the Tipsterland catalogue?”
Summary
| Tool | What it does | Changes anything? |
|---|---|---|
mi_cuenta | Plan, basic stats and today's limits | No |
listar_mis_picks | Your picks, with filters | No |
ver_pick | One pick's details | No |
crear_pick | Posts a pick (free, channel, paid or scheduled), optional image | Yes |
marcar_resultado | Won, lost, void or pending | Yes · result only |
cerrar_venta | Takes a paid pick off sale and opens it to everyone | Yes · can't be undone |
recalcular_como_ganado | Half won or won at different odds | No · sends a request |
recalcular_como_perdido | Half lost or partial loss | No · sends a request |
listar_mis_canales | Your channels and subscribers | No |
publicar_en_canal | Channel message, now or scheduled, optional image | Yes |
crear_post | Feed post, optional image | Yes |
mis_estadisticas | Yield, hit rate and profit | No |
mis_ingresos | Earnings and payouts | No |
listar_descuentos | Your discounts | No |
crear_descuento | Creates a discount (max 50%) | Yes |
desactivar_descuento | Turns off a discount | Yes |
buscar_catalogo | Sports, competitions and bookmakers | No |
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.