Skip to main content
Glama
yosle

TropiPay MCP Server

by yosle

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TROPIPAY_BASE_URLNoCustom API base URL (overrides environment)
TROPIPAY_CLIENT_IDYesYour TropiPay API client ID
TROPIPAY_ENVIRONMENTNoEnvironment: sandbox or productionsandbox
TROPIPAY_CLIENT_SECRETYesYour TropiPay API client secret

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}
prompts
{}
resources
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_default_account_balanceA

Get the current selected as default account balance from TropiPay

get_profile_dataA

Get user profile information from TropiPay account

get_movement_listA

Get list of account movements/transactions (requires ALLOW_GET_MOVEMENT_LIST scope).

šŸ“‹ Response Structure:

  • count: Total number of movements available

  • rows: Array of movement objects with the following key fields:

  • id: Unique movement identifier

  • amount: Transaction amount (+ for credits, - for debits)

  • currency: Currency code (USD, EUR, etc.)

  • movementTypeId: Type classification (1=Transfer, 2=Card Credit, 3=Refund, 4=Card Refund, 5=Top Up, 6=Exchange, 7=ATM, 8=Fee, 9=Adjustment)

  • state: Transaction status (2=Charged, 3=Paid, 4=Error, 5=Pending In, 6=Cancelled)

  • bankOrderCode: Transaction identifier (TX prefix for regular, DEV for refunds)

  • balanceBefore/balanceAfter: Account balance before/after transaction

  • reference: User-defined reference

  • conceptTransfer: Transaction description

  • completedAt/createdAt: Transaction timestamps

  • fee: Transaction fee (if applicable)

  • accountId: Id of the account that this movement belongs

  • originalCurrencyAmount: Amount in original currency

  • destinationAmount: Amount in destination currency

  • destinationCurrency: Destination currency code

  • conversionRate: Applied rate for this movement

  • paymentcard: uuid of asociated paymentcard to this movement or null otherwise šŸ’” Tip: Use the 'tropipay_movements_schema' prompt for detailed field explanations.

get_accounts_listB

Get list of TropiPay accounts associated with the user

list_deposit_accountsA

Get list of deposit accounts (a.k.a beneficiaries).

šŸ’” Tip: deposit accounts are also refered as beneficiaries can be internal (other Tropipay accounts) or external (bank accounts, external cripto wallets)

šŸ“‹ Response Structure:

  • `Array of depositaccounts objects:

  • id: Unique deposit account identifier

  • accountNumber: IBAN for external bank accounts, wallet address for external crypto accounts, email of user for internal beneficiaries)

  • alias: if not null, User-friendly account name/alias set by user

  • currency: Account currency

  • type: Account type (9=Tropipay account, 12=Crypto wallet, 7=Other, 8=BANDEC card, 4= BPA card, 3=BANMET card)

  • state: Account status (0=Active, 1=Inactive, 2=Deleted)

  • countrydestination: Object with info about the country where the account is registered,slug, name etc

  • userRelationTypeId: Type of relation with the user (0=myself, 3=commercial)

  • createdAt/updatedAt: Account creation and modification timestamps

  • firstName: First name of the beneficiary with the account

  • lastName: Last name of the beneficiary with the account

create_paymentcardA

Create a new payment card (payment link) using TropiPay API. IMPORTANT:- NEVER create payment cards without first asking the user for required information- ALWAYS collect: amount, currency, concept, and description before proceeding- DO NOT generate or assume default values for required fields- Ask clarifying questions if any information is missing or unclearRequired Information to Collect from User:

  • amount, currency, concept, description

  • Any specific requirements (expiration, single use, etc.)

šŸ“‹ Optional Fields:

  • reference

  • favorite

  • singleUse

  • expirationDays

  • reasonId

  • lang

  • urlSuccess

  • urlFailed

  • urlNotification

  • serviceDate

  • accountId šŸ” Process Flow:

  1. First ask user for: amount, currency, concept, and description

  2. Optionally ask about: expiration days, single use, reference, redirect URLs

  3. Then create the payment card with provided information

  4. Return the payment card information to the user

test_connectionA

Test the connection to TropiPay API and verify authentication by retrieving the selected default account balance

list_paymentcardsA

Get list of paymentcards (paylinks) created by the user

create_external_beneficiaryA

Create a new external bank account beneficiary using TropiPay API.

Required: firstName, lastName, accountNumber, currency, countryDestinationId/countryISO

Example:

{
  "firstName": "Panfilo",
  "lastName": "Epifanio",
  "accountNumber": "ES91 2100 0418 4502 0005 1332",
  "currency": "EUR",
  "countryDestinationId": 1,
  "swift": "CAIXESBBXXX",
  "address": "Gran Via de les Corts Catalanes, 765",
  "city": "Barcelona",
  "province": "Barcelona",
  "postalCode": "08013"
}
create_internal_beneficiaryA

Create a new internal TropiPay beneficiary using TropiPay API.

Required: alias, searchValue (email)

Example:

{
  "alias": "MR Buchman",
  "searchValue": "wick@gmail.com",
  "searchBy": 1
}
create_crypto_beneficiaryA

Create a new crypto wallet beneficiary using TropiPay API.

Required: firstName, lastName, accountNumber (wallet address), currency, network

Example:

{
  "firstName": "John",
  "lastName": "Doe",
  "accountNumber": "5Hw3k2c4Z5oLWxfTMT8nBnhqWF4SWcAFQLnJTJPzNe2y",
  "currency": "USDC",
  "network": "SOLANA"
}

Prompts

Interactive templates invoked by user choice

NameDescription
tropipay_movements_schemaGet comprehensive schema documentation for TropiPay movements/transactions data structure
tropipay_accounts_schemaGet comprehensive schema documentation for TropiPay accounts data structure

Resources

Contextual data attached and managed by the client

NameDescription
TropiPay ConfigurationCurrent TropiPay API configuration and environment settings
API StatusTropiPay API connection status and health check
Movement Types ReferenceComplete reference of TropiPay movementType IDs and their meanings
Movement States ReferenceComplete reference of TropiPay movement state codes and their meanings
Account States ReferenceComplete reference of TropiPay account state codes and their meanings

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yosle/tropipay-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server