Tools reference
Tools reference
The 14 tools of the Tipsterland MCP: what each one does, what data it uses, how to add an image and example prompts.
These are the 14 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),
- 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 €2: over 9.5 corners in Sevilla v Valencia, odds 1.95, stake 2. Make it free when the match kicks 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.”
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 or PDF |
The image can reach Tipsterland in two ways:
- As a link (
imagen_url): anhttps://address that leads straight to the image. This works everywhere, including claude.ai and ChatGPT. - Attached (
imagen_base64): the image travels inside the request itself. Only in clients that can read the file and send it, such as those running on your computer (Claude Code, for example), and it only makes sense for small images. Even then, a link is usually easier.
For the link 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”
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 |
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. 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.