Toolpin Monitor a server

Souvenir

finance.souvenir/coins · v1.3.0 · MCP 2025-11-25

Souvenir prize coins on Solana: search coins and rounds, launch and trade coins, claim wins.

Reachability reachable
checked 2026-11-21 05:43 UTC
Registry status active
Tools pinned 26
c31fcb744ef5
Tools last changed 2026-11-20

Provenance

Registry namespace finance.souvenir (domain verified by the official registry)
Website https://souvenir.finance/llms.txt
Remote endpoints
https://souvenir.finance/mcp (streamable-http)

Observed changes

When (UTC)EventDetail
2026-11-20 05:42 tools changed 0 added, 0 removed, 5 changed
2026-11-19 05:40 tools changed 0 added, 0 removed, 10 changed
2026-11-17 05:38 tools changed 1 added, 0 removed, 8 changed
2026-11-15 05:35 tools changed 0 added, 0 removed, 8 changed
2026-11-14 05:35 tools changed 2 added, 0 removed, 3 changed
2026-11-12 05:33 tools changed 0 added, 0 removed, 2 changed
2026-11-10 05:31 first capture 23 tools pinned

Pinned tool definitions (26)

ToolDescription
search_coins Lists coins on Souvenir, searched and sorted. Answers { coins, nextCursor }. Each coin: mint, symbol, name, image, venue (pump, meteora or bags), origin (launched on Souvenir or brought), mode (full: its rounds draw an item; draws: they...
get_coin One coin by its mint address, as search_coins lists it: mint, symbol, name, image, venue (pump, meteora or bags), origin (launched on Souvenir or brought), mode (full: its rounds draw an item; draws: they pay drawSol in SOL; prizes: its...
get_rounds A coin's rounds, newest first, 50 a page. Answers { rounds, next }; each round: number, state, prize, winner, drawnAt, deliveredAt, paidSol (SOL paid to the winner, else null). For older rounds, pass next back as cursor; it is null on...
get_round One round in full: { round } with its mode, target and pot, its state in words (stateText), and its proof: the holder snapshot's slot, the ticket total, the Merkle root, the drand round and randomness, and the winning ticket (SHA-256 of...
sign_in_challenge The first step of launching: { id, message, expiresAt } for your Solana wallet. Sign message (its UTF-8 bytes) with the wallet's ed25519 key and give id and the signature (base64) to sign_in within 5 minutes. Signing it authorizes no...
sign_in The signed challenge: { token, wallet, expiresAt }, a token for an hour (then sign in again) that the launch tools take as token, or that the request sends as Authorization: Bearer <token>. Launching a coin, in order: (1)...
launch_options What launching takes now for your wallet, as the site's launch form reads it: allowed and its reason, venues (meteora: Souvenir's own curve; pump: pump.fun), feeLevels and shareLevels in basis points, defaults, tickets (the ticket...
search_prizes Prizes a coin can be launched with now, from Souvenir's catalogue: { prizes, total, next }. Each prize: id (what prepare_launch takes as skin), title, kind, priceUsd, from (true: a family priced from its smallest, which id names),...
shopper_sample For a shopper coin, one that picks its own prizes: what a shopper with this brief and price band would start with, as the site's launch form asks it: { id, prize: { name, title, image, priceUsd, store }, why, count }. The brief is a...
prepare_launch Prepares your launch, as the site's launch form does (the same checks, fees and rules): stores the picture and the coin's metadata and answers { mint, transaction, summary }, the transaction base64 for your wallet to sign (a pump.fun...
submit_launch Your wallet's signed launch: Souvenir checks it is the prepared one (your wallet may only add its compute budget or guard instructions), adds the coin's own signature and sends it. Answers { signature }. Then launch_status. Takes the...
launch_status Where your launch stands, as the site's page follows it: { status, mint } with status pending (ask again in a few seconds), split (a pump.fun launch landed: transaction is the second approval, the split of its creator fee, for your...
submit_split The split launch_status handed over, approved by your wallet: either the signature of the transaction your wallet signed and sent itself, or the signed transaction (base64) for Souvenir to send. Answers { signature }. Then launch_status...
quote_trade What a buy or a sell of a Souvenir coin gives now, as the coin's page quotes it: { out, minOut, feeLamports, partial, venue }. out and minOut are the coin's raw units for a buy, lamports for a sell; minOut is the least you get at...
build_trade The trade's transaction for your wallet to sign, as the coin's page builds it: { transaction, out, minOut }, the transaction base64 (unsigned, version 0, paid by your wallet). It changes nothing until your wallet signs it and it is...
send_transaction Sends a transaction your wallet signed (base64, every signature in place) to Solana, as the site sends what a wallet signs: { signature }. Only one Souvenir built for you in the last few minutes (build_trade, or prepare_launch's devSwap...
request_trade For an agent helping a person who holds their own wallet: a link (url) for them to open, see this trade with a fresh quote, and approve it with their own wallet on souvenir.finance. Answers { id, url, state, expiresAt, side, amount,...
trade_request How an approval link from request_trade stands: { id, url, state, expiresAt, side, amount, slippageBps, coin, wallet, signature, out }. state: open (waiting for the person), sent (they approved and the trade is on its way to Solana),...
my_wins Your wallet's wins, as the site's prizes page reads them: { wins, link, evmAddress }, the newest first. Each win: mint, symbol, number (its round), skin (the prize), state (drawn: waiting for you; buying, sent, delivered; owed_sol,...
claim_sol Takes a won prize's SOL instead of the prize now, as the prizes page does, through the site's own route for that kind of prize: its share of the prize's worth (my_wins solOffer: 75% for a skin or a case, 66% for most others, 60% for a...
recent_wins The latest wins on Souvenir, newest first, as the site's Recent winners lists them: { wins }, each with mint, symbol, coinImage, skin (the prize), skinImage, winner, winnerShort, round, at, state, ordered, claimRule, lastCall,...
get_holders A coin's holders now, as its page shows them: { slot, total, streak, holdHours, holders }, the 50 with the most draw tickets: owner, amount (the coins held now, raw units), tickets, multiplier (1 to 2 with holding streaks, to 3 with...
create_coin_key A coin key for the coins your wallet created, as the coin page's Developers dialog makes one: { key, id, webhookSecret, view }. The key (ck_live_…) and the webhook secret are shown this once: keep them. It works for set_coin_mode and...
revoke_coin_key Ends one of your coin keys now, as the coin page's Developers dialog does: { ok }. It is refused from then on and its webhook stops; it can't be made live again. id is the key's id, as create_coin_key answered it (GET...
set_coin_mode Your coin's mode from its next round (the round filling keeps its own): full (its rounds draw its prize), draws (each round pays drawSol in SOL to its winner), prizes (you give prizes from its pot with award_prize; only a coin nobody...
award_prize A coin in prizes mode: gives winner an item, bought now from the coin's open pot at its fresh price plus a round's margin, as a round of the coin's: { round }. item is an id from search_prizes. The same idempotencyKey again answers the...
Get alerted when this changes. Email the moment finance.souvenir/coins drifts, dies, or revives.

Status badge

Toolpin status badge for finance.souvenir/coins

[![Toolpin](https://toolpin.dev/badge/finance.souvenir/coins.svg)](https://toolpin.dev/servers/finance.souvenir/coins)

Maintain this server? Add the badge to your README. It links your users to this live status page.