Agent-TS Tools Reference
The Agent uses OpenAI function calling with 20 tools organized into 5 categories.Tool Categories
Registration Tools
check_user_registration
Check if a phone number is registered as subscriber or agent.register_subscriber
Register a new subscriber account.KYC Tools
upload_kyc_image
Upload and validate a KYC document image.Image data is passed via message context, not as a parameter.
upgrade_kyc
Complete KYC upgrade after both ID sides are validated.Wallet Tools
check_balance
Check wallet balance. Requires PIN.{ balance: number, currency: string }
get_transactions
Get transaction history. Requires PIN.initiate_transfer
P2P transfer to another user’s card. Requires PIN.get_account_limits
Get transaction limits based on KYC level.change_subscriber_pin
Change subscriber’s PIN. Requires old PIN.request_account_statement
Generate and send PDF account statement.Card Tools
get_user_cards
List all cards linked to user.link_card
Link a new card to account.create_child_card
Create a child card with spending limits.change_child_card_pin
Change PIN for a child card.block_card
Block a card.unblock_card
Unblock a blocked card.Agent Tools
check_agent_balance
Check agent float balance. Requires PIN.agent_cash_in
Perform cash-in for a subscriber. Requires PIN.transfer_to_sub_agent
Transfer float to sub-agent. Requires PIN.change_agent_pin
Change agent’s PIN. Requires old PIN.Security Notes
Next Steps
API Endpoints
REST endpoint documentation
KYC Validation
Document validation details