cambio-currencies-list

Retrieve available currencies for exchange rate queries from Brazilian public data services.

Instructions

List all available currencies for exchange rates

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

src/tools/cambio/index.ts:15-37 (handler)

Implements the core logic of the 'cambio-currencies-list' tool: fetches currency list from Brasil API endpoint `/cambio/v1/moedas`, handles errors, formats the currencies into a newline-separated list, and returns a structured text response.

  async () => {
    console.error("Listing all available currencies");
    
    const result = await getBrasilApiData(`/cambio/v1/moedas`);
    
    if (!result.success) {
      return formatErrorResponse(`Error listing currencies: ${result.message}`);
    }
    
    // Format the response data
    const currencies = result.data;
    const formattedCurrencies = currencies.map((currency: any) => 
      `${currency.simbolo} - ${currency.nome} (Type: ${currency.tipo_moeda})`
    ).join("\n");
    
    return {
      content: [{ 
        type: "text" as const, 
        text: `Available Currencies:\n${formattedCurrencies}` 
      }]
    };
  }
);

src/tools/cambio/index.ts:14-14 (schema)
Input schema: empty object `{}`, no parameters required.
```
{},
```
src/tools/cambio/index.ts:11-14 (registration)
Direct registration of the 'cambio-currencies-list' tool using `server.tool()` with name, description, and input schema.
```
server.tool(
  "cambio-currencies-list",
  "List all available currencies for exchange rates",
  {},
```
src/index.ts:30-30 (registration)
Top-level invocation of `registerCambioTools(server)` in the main MCP server setup, which registers the cambio tools including 'cambio-currencies-list'.
```
registerCambioTools(server);
```

src/utils/api.ts:11-40 (helper)

Shared `getBrasilApiData` helper function called within the handler to perform HTTP GET requests to the Brasil API and handle responses/errors.

export async function getBrasilApiData(endpoint: string, params: Record<string, any> = {}) {
  try {
    const url = `${BASE_URL}${endpoint}`;
    console.error(`Making request to: ${url}`);
    
    const response = await axios.get(url, { params });
    return { 
      data: response.data,
      success: true
    };
  } catch (error: any) {
    console.error(`Error in API request: ${error.message}`);
    
    // Handle API errors in a structured format
    if (error.response) {
      return {
        success: false,
        statusCode: error.response.status,
        message: error.response.data?.message || error.message,
        error: error.response.data
      };
    }
    
    return {
      success: false,
      message: error.message,
      error
    };
  }
}

Brasil API MCP