Developers
MCP connector
A hosted MCP server that lets Claude, ChatGPT, Grok and other assistants read a Talise account and pay within an Agent Pass.
The Talise connector is a remote MCP server at https://app.talise.io/mcp. You add it to your assistant once, sign in to Talise, and the assistant can check your balance, read your activity and send money for you. It can only pay without asking when you give it an Agent Pass: a daily limit you choose and Sui enforces.
https://app.talise.io/mcpAt a glance
| Property | Value |
|---|---|
| Server URL | https://app.talise.io/mcp |
| Transport | Streamable HTTP. Every request is signed in on its own. |
| Sign-in | OAuth 2.1 with PKCE, as the account holder. No client secret. |
| Tools | 16 tools and 6 prompts |
| Moving money | Only within an Agent Pass, or with the account holder’s approval |
Add the connector
Paste the connector URL wherever your assistant adds a custom connector or remote MCP server. Your assistant opens the Talise sign-in by itself.
Claude
Open connectors
On claude.ai, open Settings → Connectors. A connector you add there also appears in Claude Desktop.
Add Talise
Choose Add custom connector, name it Talise and paste
https://app.talise.io/mcp.Connect
Choose Connect, sign in to Talise and allow access.
ChatGPT
Turn on developer mode
Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.
Create the connector
Back in Apps & Connectors, choose Create, name it Talise, paste the connector URL and pick OAuth.
Sign in and use it
Sign in to Talise and allow access. In a chat, turn Talise on from the + menu.
Grok
Add a custom connector
Go to grok.com/connectors and choose New Connector → Custom.
Fill in the details
Name it Talise, paste the connector URL and enter the values below.
Connect
Choose Save & Connect, sign in to Talise and allow access.
| Field | Value |
|---|---|
| Client ID | grok |
| Client secret | Leave blank |
| Authorization URL | https://app.talise.io/oauth/authorize |
| Token URL | https://app.talise.io/oauth/token |
| Scopes | talise offline_access |
| Token auth method | None (PKCE only) |
Other MCP clients
Perplexity, Le Chat, Cursor and most apps that take MCP: add a custom or remote MCP connector and paste the connector URL. Most never ask for a Client ID because they register themselves automatically. If Perplexity or Le Chat asks for one, use talise and leave the secret blank.
Apps that read a config file, such as Cursor, VS Code and Windsurf, take this:
{
"mcpServers": {
"talise": { "url": "https://app.talise.io/mcp" }
}
}Bots and scripts
A bot can’t sign in through a browser, so it uses a personal access token. In Talise, open Settings → Connected apps → Access tokens and choose Create token. The token is shown once, so copy it then. Send it as a bearer token to the same URL.
curl -X POST https://app.talise.io/mcp \
-H 'Authorization: Bearer tls_pat_••••' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_balance","arguments":{}}}'Sign-in and consent
The first time your assistant connects, Talise walks you through three screens:
Sign in to Talise
Choose Continue with Google, or Use the Talise app and approve a short code in the app. The app route works for Apple accounts, and for an email different from the one in your browser.
Allow access
The consent screen names the assistant you’re connecting. Choose Allow to let it read your account and ask to pay.
Set a daily limit (optional)
Talise offers an Agent Pass straight after you connect. Pick a limit and sign once; within it, the assistant pays without asking. Skip it and every payment needs your approval.
Your assistant stays connected after that. You’ll be asked to sign in again from time to time. Disconnecting an assistant in Settings → Connected apps ends its access at once.
Tools
The connector offers 16 tools. Each result has a text part written for the model, structured data in structuredContent, and any links as resource_link items. When a tool can’t do what was asked, it returns a normal result with isError: true and a plain-language reason, never a protocol error.
| Tool | Title | Needs an Agent Pass |
|---|---|---|
get_account_overview | Talise overview (start here) | No |
get_spending_allowance | Check your Agent Pass | No |
request_agent_pass | Request an Agent Pass | No |
get_balance | Get balance | No |
recent_activity | Recent activity | No |
find_recipient | Check who a name pays | No |
list_recent_recipients | People you’ve paid | No |
send_money | Send money | Yes, always |
add_money_naira | Add money with naira | No |
get_add_money_status | Get add-money status | No |
list_bank_accounts | List saved bank accounts | No |
find_bank | Find a Nigerian bank | No |
check_bank_account | Check a bank account | No |
quote_cash_out | Quote a cash-out | No |
prepare_cash_out | Cash out to a bank | Pays instantly with a pass; otherwise an approval link |
get_cash_out_status | Get cash-out status | No |
Calling a tool
Your MCP client builds these messages for you. This is what a send_money call and its receipt look like on the wire, and what a refusal looks like when the assistant has no pass.
{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "send_money",
"arguments": { "to": "amara@talise", "amount_usd": 5 }
}
}Start here
get_account_overview
Call this first in any conversation about money. One call returns the balance, the Agent Pass and what the assistant can pay right now, saved bank accounts, people paid recently, and which tool does which job. It also says which country the account is registered in, so the assistant knows whether the naira tools apply. Read-only.
Takes no inputs.
{}Agent Pass
get_spending_allowance
What the assistant can pay right now, its daily limit, what’s left today, when the limit resets and when the pass expires. If part of the balance needs a tap before the pass can use it, the result includes a one-tap link that fixes it. Structured fields include spendable_now_usd, daily_limit_usd, left_today_usd, resets_at and expires_at. Read-only.
Takes no inputs.
{}request_agent_pass
Returns a one-tap link the person opens in Talise to issue or raise this assistant’s pass. The limit and expiry in the link are suggestions: the person picks the final values and signs. Nothing is granted until they do. Use it only when there’s no pass, it has expired, or the limit is too small.
daily_limit_usdnumberexpires_in_days7 | 30 | 90{ "daily_limit_usd": 25, "expires_in_days": 30 }Account
get_balance
The balance in US dollars (USDsui, worth $1.00 each): the amount available to send or cash out. Read-only.
Takes no inputs.
{}recent_activity
The most recent transactions, newest first: sends, receipts, cash-outs and money added, including which ones an assistant paid from an Agent Pass. Read-only.
limitinteger{ "limit": 10 }Pay a person
find_recipient
Before sending, checks who a Talise name, .sui name or Sui address pays: the resolved name and address, whether it’s the person’s own wallet, and whether they’ve paid it before. Never sends.
tostringRequiredamara or amara@talise), a .sui name, or a 0x Sui address.{ "to": "amara@talise" }list_recent_recipients
People the person has sent money to recently, newest first, with how often and the last amount. Use it to turn “send Amara again” into the exact name or address for send_money. Read-only.
limitinteger{ "limit": 5 }send_money
Sends USDsui to a Talise name, a .sui name or a Sui address, paid instantly from the assistant’s Agent Pass. It settles on Sui in under a second and returns the receipt. If it can’t pay (no pass, over today’s limit, or not enough balance), nothing is sent and the result says why, with the one fix to pass on. A repeat of the same payment moments later is refused, so a retried request can’t pay twice.
tostringRequiredamara or amara@talise), a .sui name, or a 0x Sui address.amount_usdnumberRequired{ "to": "amara@talise", "amount_usd": 12.5 }Naira tools
These tools apply to accounts registered in Nigeria. get_account_overview tells the assistant whether they apply, and for other accounts it never offers them.
add_money_naira
Opens a naira deposit and returns a one-time account number, the bank and the exact amount to transfer from the person’s own bank app. Once it lands, USDsui arrives in their Talise wallet. Money only comes in, so no Agent Pass is needed. Follow it with get_add_money_status.
amount_ngnnumberRequired{ "amount_ngn": 20000 }get_add_money_status
Checks a naira deposit: waiting for the transfer (with the account to pay), arrived and on its way, done (with the amount received), expired or failed.
order_idstringRequiredorder_id from add_money_naira.{ "order_id": "<order_id from add_money_naira>" }list_bank_accounts
Saved Nigerian bank accounts (the person’s own and saved recipients): bank name, account holder, last 4 digits and an id to pass to prepare_cash_out. Full account numbers are never returned. Read-only.
Takes no inputs.
{}find_bank
Searches Nigerian banks by name and returns the bank code that check_bank_account and prepare_cash_out need. Read-only.
querystringRequired{ "query": "First Bank" }check_bank_account
Asks the bank who owns an account and returns the account holder’s name. The assistant reads the name back to the person before the first cash-out to it. Read-only.
bank_codestringRequiredfind_bank.account_numberstringRequired{ "bank_code": "<code from find_bank>", "account_number": "0123456789" }quote_cash_out
Quotes a cash-out for the naira amount the bank should receive: the rate in naira per $1.00, the total taken from the balance (including any cost), whether it fits within the person’s cash-out limit, whether the balance covers it, and whether the Agent Pass will pay it at once. Nothing is created.
amount_ngnnumberRequired{ "amount_ngn": 50000 }prepare_cash_out
Cashes out in naira to a Nigerian bank account. Pass a saved bank_account_id, or a bank_code and account_number. Talise checks the account name, the rate and the balance again. When the Agent Pass covers the total, it’s sent instantly. When it can’t, the result says it wasn’t paid from the pass, gives the reason and its fix, and includes an approval link for this one payment. The smallest cash-out is ₦1,000.
bank_account_idstringlist_bank_accounts.bank_codestringfind_bank, when you’re not using a saved account.account_numberstringamount_ngnnumberRequired{ "bank_account_id": "<id from list_bank_accounts>", "amount_ngn": 50000 }get_cash_out_status
Follows a cash-out: pending approval, processing, completed, failed, expired or cancelled, with a plain-language summary.
approval_idstringRequiredapproval_id from prepare_cash_out.{ "approval_id": "<approval_id from prepare_cash_out>" }Prompts
Apps that support MCP prompts (Claude’s + menu and slash commands, Grok and many desktop clients) list these ready-made requests. Each one is plain words that name the tools to use, so it works the same in any assistant.
| Prompt | Title | Arguments |
|---|---|---|
talise_overview | What’s in my Talise? | None |
pay_someone | Send money | to (required), amount_usd |
set_up_agent_pass | Set up an Agent Pass | daily_limit_usd |
recent_activity | What’s happened lately? | None |
add_money_naira | Add money with naira | amount_ngn |
cash_out | Cash out to my bank | amount_ngn |
Prompt arguments arrive as text, so $5, 5,000 and ₦20000 all work.
How spending works
Reading never needs an Agent Pass. Moving money out does:
send_moneyonly pays from a pass. Without one, or over its limit, nothing is sent and the assistant gets the one fix to pass on.prepare_cash_outpays instantly when a pass covers the total. Otherwise it returns an approval link that opens Talise with the amount, the bank and the live rate. The money moves only when you confirm. Each link works once and only for a short time, so open it straight away.add_money_nairaneeds no pass: money only comes in, always to your own wallet.
An assistant can never issue, raise or revoke a pass itself. request_agent_pass only hands you a link; you choose the limit and sign in Talise. Sui checks every payment against the pass, so an assistant can’t spend more than you allowed.
When something goes wrong
Nothing moves when a tool refuses. The result tells the assistant what to say and the one fix to offer.
| Situation | What the assistant gets |
|---|---|
| Not signed in | “Not signed in to Talise. Reconnect the Talise connector.” Your client takes you through sign-in. |
| No Agent Pass, or it expired | Nothing was sent, plus issue_pass_url: a one-tap link to issue or renew a pass. |
| Over the pass’s daily limit | What’s left and when it resets (left_today_usd, daily_limit_usd), plus a link to raise the limit. |
| Part of the balance needs a tap first | A one-tap Move into reach link (move_into_reach_url). Call the same tool again afterwards. |
| Not enough balance | Nothing was sent, and the result says the balance is too low. |
| Same payment moments ago | Nothing new was sent, plus the earlier payment’s receipt, so a retry never pays twice. |
| Unknown recipient | “Couldn’t find a Talise user or Sui address called …”. Check the name with the person. |
| A safety check stopped the payment | Nothing was sent, with the reason. |
| Too many calls | How long to wait before trying again. |
Disconnect
In Talise, open Settings → Connected apps and choose Disconnect. The assistant loses access at once. Disconnecting doesn’t remove its Agent Pass on Sui: revoke that too in Agent Passes if you want the allowance gone.