Agents Index

Souvenir

OnlineNew

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

Visit publisherConnectJSON

What it can do: 26 tools

  • search_coins read-onlyLists 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 i
  • get_coin read-onlyOne 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
  • get_rounds read-onlyA 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;
  • get_round read-onlyOne 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 ti
  • sign_in_challengeThe 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
  • sign_inThe 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 read-onlyWhat 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 (
  • search_prizes read-onlyPrizes 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
  • shopper_sampleFor 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 }. Th
  • prepare_launchPrepares 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 sig
  • submit_launchYour 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_stat
  • launch_statusWhere 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 fe
  • submit_splitThe 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 }. Th
  • quote_trade read-onlyWhat 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 y
  • build_trade read-onlyThe 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 i
  • send_transactionSends 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_
  • request_tradeFor 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, s
  • trade_request read-onlyHow 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 wa
  • my_wins read-onlyYour 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
  • claim_solTakes 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 oth
  • recent_wins read-onlyThe 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, las
  • get_holders read-onlyA 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 streak
  • create_coin_keyA 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_
  • revoke_coin_keyEnds 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 /a
  • set_coin_modeYour 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
  • award_prizeA 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 ag

Connect it

Claude Code
claude mcp add --transport http souvenir https://souvenir.finance/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://souvenir.finance/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "souvenir": {
      "url": "https://souvenir.finance/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "souvenir": {
      "type": "http",
      "url": "https://souvenir.finance/mcp"
    }
  }
}

Questions

What does Souvenir do?

Souvenir prize coins on Solana: search coins and rounds, launch and trade coins, claim wins. It exposes 26 tools to AI assistants.

What tools does Souvenir provide?

26 tools, including search_coins, get_coin, get_rounds, get_round, sign_in_challenge, sign_in, launch_options, search_prizes, shopper_sample, prepare_launch, submit_launch, launch_status….

How do I connect Souvenir to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://souvenir.finance/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does Souvenir require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Souvenir online?

As of 2026-11-19 our probe found it online. It answered 67% of our last 3 checks.

Who publishes Souvenir?

souvenir.finance. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Web Search & Scraping