Tools & Prompts
Every tool the Snippe MCP server exposes, and the prompts that guide an agent through them
Amounts are always whole Tanzanian Shillings — 500 means 500 TZS, not cents. Currency, webhook URL, and base metadata come from headers and are never tool parameters.
Console exposes all 10 tools. Checkout exposes the 6 collection tools — or 5, if you connect with a plk_ link key, since the mobile-money push drops out.
Collection tools
Available on both servers.
| Tool | Required | What it does |
|---|---|---|
create_mobile_payment (API key only) | phone_number, amount, firstname, lastname, email | Charges a customer by mobile money; they get a USSD push to enter their PIN. Requires X-Webhook-Url. |
create_payment_link | amount | Hosted payment link for a fixed amount; the customer pays by mobile money or card. |
create_itemized_link | amount, line_items | Payment link showing an itemized cart. |
create_custom_amount_link | min_amount, max_amount | Pay-what-you-want link — tips, donations, top-ups. The customer picks the amount. |
get_session | reference | Status and details of one checkout session or link. |
cancel_session | reference | Cancels a pending or active session. Does not refund a paid one. |
line_items is a list of {name, quantity, unit_price, total}, max 50 entries. create_custom_amount_link also takes an optional suggested_amount to pre-fill within the range.
Optional parameters on the link tools
| Parameter | Effect |
|---|---|
customer_name, customer_phone, customer_email | Prefills the checkout page. Omit and the customer fills them in. |
description | Text shown on checkout, up to 500 characters. |
redirect_url | Where the customer lands after paying. |
allowed_methods | A subset of ["mobile_money", "card"]. Defaults to mobile money. |
expires_in | Link lifetime in seconds, from 60 to 604800. |
metadata | Per-call key–value data, merged over the X-Metadata base. Per-call wins. |
create_custom_amount_link takes description, redirect_url, and metadata only — no customer prefill, methods, or expiry.
Account tools
Console only. A Checkout agent can't see any of this.
| Tool | Required | What it does |
|---|---|---|
payment | payment_reference | Status and details of one payment. |
payments | — (limit, offset) | Browse recent payments, newest first. |
get_balance | — | Available and pending balance. |
list_sessions | — (limit, offset, status) | Browse checkout sessions. |
Prompts
Each prompt is a short playbook telling the agent how to complete a workflow: what to collect, what never to ask, and which tool to call. Your client fetches them over prompts/list and prompts/get.
| Prompt | Server | Guides |
|---|---|---|
collect_mobile_payment | Both | Collecting a mobile-money payment via USSD push. |
send_payment_link | Both | Creating and sharing a fixed-amount payment link. |
send_itemized_link | Both | Creating a link with an itemized cart. |
send_custom_amount_link | Both | Creating a pay-what-you-want link. |
check_balance | Console | Reporting the account balance. |
reconcile_payment | Console | Looking up or confirming a payment or session status. |
Full agent system prompts built on these — a donation bot and a shop bot with a product catalog — live in examples/prompts/ in the repo.