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.

Connector URL
https://app.talise.io/mcp

At a glance

PropertyValue
Server URLhttps://app.talise.io/mcp
TransportStreamable HTTP. Every request is signed in on its own.
Sign-inOAuth 2.1 with PKCE, as the account holder. No client secret.
Tools16 tools and 6 prompts
Moving moneyOnly 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

  1. Open connectors

    On claude.ai, open Settings → Connectors. A connector you add there also appears in Claude Desktop.

  2. Add Talise

    Choose Add custom connector, name it Talise and paste https://app.talise.io/mcp.

  3. Connect

    Choose Connect, sign in to Talise and allow access.

ChatGPT

  1. Turn on developer mode

    Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode.

  2. Create the connector

    Back in Apps & Connectors, choose Create, name it Talise, paste the connector URL and pick OAuth.

  3. Sign in and use it

    Sign in to Talise and allow access. In a chat, turn Talise on from the + menu.

Grok

  1. Add a custom connector

    Go to grok.com/connectors and choose New Connector → Custom.

  2. Fill in the details

    Name it Talise, paste the connector URL and enter the values below.

  3. Connect

    Choose Save & Connect, sign in to Talise and allow access.

FieldValue
Client IDgrok
Client secretLeave blank
Authorization URLhttps://app.talise.io/oauth/authorize
Token URLhttps://app.talise.io/oauth/token
Scopestalise offline_access
Token auth methodNone (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:

mcp.json
{
  "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.

Call a tool with a personal access token
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":{}}}'

The first time your assistant connects, Talise walks you through three screens:

  1. 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.

  2. Allow access

    The consent screen names the assistant you’re connecting. Choose Allow to let it read your account and ask to pay.

  3. 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.

ToolTitleNeeds an Agent Pass
get_account_overviewTalise overview (start here)No
get_spending_allowanceCheck your Agent PassNo
request_agent_passRequest an Agent PassNo
get_balanceGet balanceNo
recent_activityRecent activityNo
find_recipientCheck who a name paysNo
list_recent_recipientsPeople you’ve paidNo
send_moneySend moneyYes, always
add_money_nairaAdd money with nairaNo
get_add_money_statusGet add-money statusNo
list_bank_accountsList saved bank accountsNo
find_bankFind a Nigerian bankNo
check_bank_accountCheck a bank accountNo
quote_cash_outQuote a cash-outNo
prepare_cash_outCash out to a bankPays instantly with a pass; otherwise an approval link
get_cash_out_statusGet cash-out statusNo

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.

Example arguments
{}

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.

Example arguments
{}

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_usdnumber
Suggested daily limit in US dollars, from 1.00 to 1,000.00.
expires_in_days7 | 30 | 90
Suggested life of the pass. If you leave it out, the pass screen pre-selects 30 days.
Example arguments
{ "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.

Example arguments
{}

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
How many to return, 1 to 25. Defaults to 10.
Example arguments
{ "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.

tostringRequired
A Talise name (amara or amara@talise), a .sui name, or a 0x Sui address.
Example arguments
{ "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
How many to return, 1 to 20. Defaults to 10.
Example arguments
{ "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.

tostringRequired
A Talise name (amara or amara@talise), a .sui name, or a 0x Sui address.
amount_usdnumberRequired
US dollars to send, up to 2 decimal places. From 0.01 up to what the pass has left today.
Example arguments
{ "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
Naira to deposit, from ₦1,000 to ₦50,000 per deposit.
Example arguments
{ "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_idstringRequired
The order_id from add_money_naira.
Example arguments
{ "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.

Example arguments
{}

find_bank

Searches Nigerian banks by name and returns the bank code that check_bank_account and prepare_cash_out need. Read-only.

querystringRequired
Part of the bank’s name.
Example arguments
{ "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_codestringRequired
The bank code from find_bank.
account_numberstringRequired
The 10-digit account number.
Example arguments
{ "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
Naira the bank account should receive, for example 50000.
Example arguments
{ "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_idstring
A saved account id from list_bank_accounts.
bank_codestring
A bank code from find_bank, when you’re not using a saved account.
account_numberstring
The 10-digit account number, when you’re not using a saved account.
amount_ngnnumberRequired
Naira the bank account should receive.
Example arguments
{ "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_idstringRequired
The approval_id from prepare_cash_out.
Example arguments
{ "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.

PromptTitleArguments
talise_overviewWhat’s in my Talise?None
pay_someoneSend moneyto (required), amount_usd
set_up_agent_passSet up an Agent Passdaily_limit_usd
recent_activityWhat’s happened lately?None
add_money_nairaAdd money with nairaamount_ngn
cash_outCash out to my bankamount_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_money only 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_out pays 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_naira needs 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.

SituationWhat 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 expiredNothing was sent, plus issue_pass_url: a one-tap link to issue or renew a pass.
Over the pass’s daily limitWhat’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 firstA one-tap Move into reach link (move_into_reach_url). Call the same tool again afterwards.
Not enough balanceNothing was sent, and the result says the balance is too low.
Same payment moments agoNothing 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 paymentNothing was sent, with the reason.
Too many callsHow 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.

Next steps