mcp_iati_top_activities_by_amount
Find IATI activities with the highest commitment or disbursement totals. Rank results per currency, with optional currency and limit filters to target specific aid flows.
Instructions
List activities with the highest commitment or disbursement totals.
Rankings are calculated independently for each currency, avoiding
comparisons between amounts expressed in different currencies.
Args:
transaction_type: Commitment or disbursement. Accepts commitment,
out commitment, disbursement, 2 or 3.
currency: Optional currency code, for example USD or EUR.
limit: Maximum results to return per currency. Default: 10.
Returns:
A table containing activity identifiers, titles, reporting
organisations, recipient countries, transaction type, currency
and total amount.
Relevant IATI terms:
- IATI activity: A development or cooperation intervention published under the IATI standard; it can represent a project, a programme or another unit of work.
IATI identifier: Globally unique code identifying an IATI activity, also used to link it to its transactions and other information.
Reporting organisation: Organisation responsible for publishing and maintaining an activity's data; not necessarily the one funding or implementing the project.
Recipient country or region: Country (ISO code) or supra-national DAC region that receives the intended benefits of an activity. May include a percentage when the activity is split across several territories.
Transaction: Financial operation associated with an IATI activity, identified by its type, date, value and currency.
Transaction type: Code indicating the nature of a financial operation: incoming funds, commitment, disbursement, expenditure, interest payment, loan repayment, reimbursement, purchase or sale of equity, credit guarantee, incoming commitment, or outgoing/incoming pledge.
Transaction value: Amount of an individual transaction, expressed in the currency stated on the value or, if unspecified, in the activity's default currency.
Commitment: Financial obligation undertaken to provide funds to an activity; it does not necessarily represent a payment already made.
Disbursement: Transfer of funds from a provider organisation to a receiver organisation to finance an activity.
Default currency: Currency declared for an activity and used whenever a financial value does not explicitly specify another currency.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| currency | No | ||
| transaction_type | No | 2 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Plain text message that bypasses LLM processing and should be printed exactly as provided in the user interface. | |
| table | No | Two-dimensional list (list of rows) representing tabular data, e.g., from CSV or TSV sources. Each row should be a list of cell values. | |
| charts | No | List of dictionaries containing data and configuration for rendering a Chart.js chart in the chat interface. | |
| sources | Yes | URL(s) that users can nagivate to to download the data used for the analysis. E.g., landing page, feed, file endpoint, CKAN resource page, etc. |