Call when no other tool can answer the question: topics that are not IATI activities, or questions outside the scope of the loaded data.

Args: reason: Brief explanation (1 sentence) of why no tool applies.

Examples: - no_tool_disponible(reason="not a question about IATI activities")

Summarise the contents of the configured IATI file.

    Use this tool for general questions such as what the file contains,
    how many activities it has, which organisations report them, which
    recipient countries and currencies appear, and how much financial
    activity is reported.

    Financial totals are kept separate by transaction type and currency.
    The result includes:
    - Total number of activities.
    - Reporting organisations and their activity counts.
    - Recipient countries and their activity counts.
    - Default currencies used by activities.
    - Transaction totals by type and currency.

    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.

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

• Default currency: Currency declared for an activity and used whenever a financial value does not explicitly specify another 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.

• Expenditure: Use of funds to purchase goods or services related to an activity; not a synonym of disbursement.

Report the date range covered by the configured IATI data.

    Use date_kind to select activity dates, transaction dates or both:
    - activities: planned and actual start and end dates.
    - transactions: dates of financial transactions.
    - all: both activity and transaction dates.

    The result reports the earliest and latest valid date together with
    counts of records containing valid, missing or invalid dates.

    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.

• Activity date: Start or end date of an activity. Each date declares one of four types: planned start, actual start, planned end or actual end.

• Transaction: Financial operation associated with an IATI activity, identified by its type, date, value and currency.

List the values present in a categorical IATI field.

    Use this tool to explore available values before applying filters.
    Supported categories are:
    - activity_status
    - transaction_type
    - sector
    - organisation_type
    - aid_type
    - finance_type
    - flow_type
    - tied_status
    - collaboration_type
    - humanitarian
    - default_currency

    The result includes each code, its readable value, its vocabulary
    when applicable, and the number of records containing it.

    Relevant IATI terms:
    - Codelist: Catalogue mapping the codes used in IATI to their allowed meanings.

• Vocabulary: Classification system used to interpret an IATI code, such as the OECD DAC CRS for sectors and policy markers, UN COFOG, the SDG goals and targets, or the IASC humanitarian clusters.

• Activity status: Stage of an activity within its lifecycle: pipeline/identification, implementation, completion, post-completion, cancelled or suspended.

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

• Sector: Thematic or economic area an activity contributes to, indicated by a code, a vocabulary and, where applicable, a percentage; sectors can be declared at activity level or per transaction.

• Organisation type: Classification of an organisation, such as government, local government, other public sector, international/national/regional NGO, public-private partnership, multilateral, foundation, private sector or academic.

• Aid type: Modality of the aid, such as budget support, pooled funds, project-type interventions, technical assistance, debt relief or cash transfers; declared as an activity default and overridable per transaction.

• Finance type: Financial instrument of the flow, such as standard grant, standard loan, reimbursable grant, bonds, equity, guarantees or debt relief/rescheduling; declared as an activity default.

• Flow type: Classification of the resource flow's origin: official development assistance (ODA), other official flows, private development finance, foreign direct investment or other private flows.

• Tied status: Whether the aid's procurement is restricted to suppliers from specific countries: tied, partially tied or untied.

• Collaboration type: Institutional channel of the activity: bilateral, multilateral (inflows), bilateral through an NGO, bilateral through a multilateral, private sector outflows, or other.

• Humanitarian flag: Marker declaring that an activity (or an individual transaction) relates entirely or partially to humanitarian aid.

• Default currency: Currency declared for an activity and used whenever a financial value does not explicitly specify another currency.

Search IATI activities whose title contains the given text.

    Useful as a first step to discover an activity's IATI identifier,
    before requesting its summary with activity_summary.

    Args:
        text: Substring to search for in the title (case-insensitive).
        limit: Maximum number of results to return. Default: 10.

    Returns:
        A table with the IATI identifier, title and status of each match.

    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.

• Activity status: Stage of an activity within its lifecycle: pipeline/identification, implementation, completion, post-completion, cancelled or suspended.

List the activity statuses present in the loaded IATI data.

    Use this tool to discover which lifecycle statuses are available
    before filtering or analysing activities.

    Returns:
        A table containing each status code, its human-readable label
        and the number of activities using it.

    Relevant IATI terms:
    - Activity status: Stage of an activity within its lifecycle: pipeline/identification, implementation, completion, post-completion, cancelled or suspended.

• IATI activity: A development or cooperation intervention published under the IATI standard; it can represent a project, a programme or another unit of work.

List the organisations that report activities in the loaded IATI data.

    The reporting organisation is responsible for publishing and
    maintaining the activity data. It is not necessarily the funding
    or implementing organisation.

    Returns:
        A table containing the organisation reference, name and number
        of activities reported.

    Relevant IATI terms:
    - Reporting organisation: Organisation responsible for publishing and maintaining an activity's data; not necessarily the one funding or implementing the project.

• IATI activity: A development or cooperation intervention published under the IATI standard; it can represent a project, a programme or another unit of work.

List the recipient countries present in the loaded IATI data.

    Use this tool to discover which country codes are available before
    filtering activities by recipient country.

    Returns:
        A table containing the recipient country code, country name and
        number of related activities.

    Relevant IATI terms:
    - 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.

• IATI activity: A development or cooperation intervention published under the IATI standard; it can represent a project, a programme or another unit of work.

Filter IATI activities by recipient country.

    The country may be provided as an ISO country code, such as "BR",
    or as the country name published in the IATI data, such as "Brazil".

    Use list_recipient_countries first when the available country codes
    or names are unknown.

    Args:
        country: Recipient country code or name.
        limit: Maximum number of activities to return. Default: 10.

    Returns:
        A table containing matching activity identifiers, titles,
        statuses and recipient-country information.

    Relevant IATI terms:
    - 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.

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

• Activity status: Stage of an activity within its lifecycle: pipeline/identification, implementation, completion, post-completion, cancelled or suspended.

List the sectors present in the loaded IATI data.

    Use this tool to discover the available sector codes and
    vocabularies before performing sector-based analysis.

    Args:
        limit: Maximum number of sector values to return. Default: 100.

    Returns:
        A table containing vocabulary, sector code, sector name and
        number of related activities.

    Relevant IATI terms:
    - Sector: Thematic or economic area an activity contributes to, indicated by a code, a vocabulary and, where applicable, a percentage; sectors can be declared at activity level or per transaction.

• Vocabulary: Classification system used to interpret an IATI code, such as the OECD DAC CRS for sectors and policy markers, UN COFOG, the SDG goals and targets, or the IASC humanitarian clusters.

• IATI activity: A development or cooperation intervention published under the IATI standard; it can represent a project, a programme or another unit of work.

Return the title, status, reporting organisation and totals per transaction type of an IATI activity.

    Args:
        iati_identifier: IATI identifier, for example "XI-IATI-IADB-BR-L1231".
            Obtained with search_activities.

    Relevant IATI terms:
    - 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.

• Activity status: Stage of an activity within its lifecycle: pipeline/identification, implementation, completion, post-completion, cancelled or suspended.

• Transaction: Financial operation associated with an IATI activity, identified by its type, date, value and 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.

• Expenditure: Use of funds to purchase goods or services related to an activity; not a synonym of disbursement.

• Default currency: Currency declared for an activity and used whenever a financial value does not explicitly specify another currency.

List the transactions associated with an IATI activity.

    Transactions are returned in chronological order and include their
    type, value, currency and published description.

    Args:
        iati_identifier: IATI identifier of the activity.
        limit: Maximum number of transactions to return. Default: 50.

    Returns:
        A table containing the transactions associated with the
        requested activity.

    Relevant IATI terms:
    - IATI identifier: Globally unique code identifying an IATI activity, also used to link it to its transactions and other information.

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

• Expenditure: Use of funds to purchase goods or services related to an activity; not a synonym of disbursement.

Group commitments and disbursements by year and currency.

    Only commitment and disbursement transactions are included. Amounts
    with different currencies are always reported separately.

    Args:
        year_from: Optional first year to include.
        year_to: Optional last year to include.

    Returns:
        A chronological table containing year, transaction type, currency
        and total amount.

    Relevant IATI terms:
    - 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.

Group commitments and disbursements by reporting organisation.

    Amounts with different currencies and transaction types are reported
    separately. The reporting organisation publishes the activity data and
    is not necessarily the organisation funding or implementing the
    activity.

    Args:
        limit: Maximum number of grouped rows to return. Default: 50.

    Returns:
        A table containing the organisation reference and name,
        transaction type, currency and total amount.

    Relevant IATI terms:
    - Reporting organisation: Organisation responsible for publishing and maintaining an activity's data; not necessarily the one funding or implementing the project.

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

Allocate commitments and disbursements across sectors.

    Amounts are distributed using the published sector percentages.
    Different vocabularies and currencies are reported separately.

    Args:
        transaction_type: Commitment or disbursement. Accepts commitment,
            out commitment, disbursement, 2 or 3.
        currency: Optional currency code, for example USD or EUR.
        vocabulary: Optional sector vocabulary code, for example 1 or 2.
        limit: Maximum number of grouped rows to return per vocabulary and
            currency. Default: 50.

    Returns:
        A table containing the vocabulary, sector, transaction type,
        currency and allocated total amount.

    Relevant IATI terms:
    - Sector: Thematic or economic area an activity contributes to, indicated by a code, a vocabulary and, where applicable, a percentage; sectors can be declared at activity level or per transaction.

• Vocabulary: Classification system used to interpret an IATI code, such as the OECD DAC CRS for sectors and policy markers, UN COFOG, the SDG goals and targets, or the IASC humanitarian clusters.

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

Group commitments and disbursements by recipient country.

    Amounts with different currencies and transaction types are reported
    separately. Missing country names fall back to the country code, and
    missing country data falls back to "Unknown recipient country".

    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 number of grouped rows to return. Default: 50.

    Returns:
        A table containing the country code and name, transaction type,
        currency and total amount.

    Relevant IATI terms:
    - 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.

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.

Explain what an IATI term means, according to the standard's glossary (activities, organisations, financial data, aid classifications, sectors and geography, results, documentation).

Useful for questions like "what does X mean?" or "what is the difference between X and Y?" (call it once per term).

Args: term: Word or phrase to look up, in English (e.g. "disbursement", "policy marker"). Partial matches are accepted.

Returns: A table with the matching glossary terms and their definitions.

List every complementary resource this server offers: documents, publications (PDF), reference datasets and external visualizers, each with its description and links.

Use this tool whenever the user asks which resources, documents,
publications, books or visualizers exist or are available, or
whether a specific one exists (e.g. "is there a data visualizer
for X?", "where can I download the annual report?").
Answer in the user's language and always include the links.

Examples: - list_available_resources()