Contents

Documentation Exchange on date

exchange-on-date

Free Read-only

Get the reference exchange rates of a currency on a past date.

Ask your assistant

Once the server is connected, a request in plain words is enough. For example:

Example request
Use Mairies de France to get the reference exchange rates of a currency on a past date, with date = "2026-01-15".

Examples

Most clients only need the server address and a sign-in: see Connect. Clients configured by a file take the first block. Your assistant then writes the second one by itself.

Client configuration
{
  "mcpServers": {
    "mairies-de-france": {
      "url": "https://mairies.vosfichiers.com/mcp"
    }
  }
}
What the assistant sends
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "exchange-on-date",
    "arguments": {
      "base": "EUR",
      "date": "2026-01-15"
    }
  }
}

Put an API key in the API_KEY environment variable first. Create a key

bash
curl -X POST https://mairies.vosfichiers.com/api/v1/exchange-on-date \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "base": "EUR",
  "date": "2026-01-15"
}'

Put an API key in the API_KEY environment variable first. Create a key

python
import json
import os
import urllib.request

payload = {
    "base": "EUR",
    "date": "2026-01-15",
}
request = urllib.request.Request(
    "https://mairies.vosfichiers.com/api/v1/exchange-on-date",
    data=json.dumps(payload).encode(),
    headers={
        "Authorization": "Bearer " + os.environ["API_KEY"],
        "Content-Type": "application/json",
    },
    method="POST",
)
with urllib.request.urlopen(request) as response:
    print(json.load(response))

Put an API key in the API_KEY environment variable first. Create a key

javascript
const response = await fetch("https://mairies.vosfichiers.com/api/v1/exchange-on-date", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "base": "EUR",
    "date": "2026-01-15"
  }),
});
console.log(await response.json());

Input

Fields this tool accepts
Field Type Required Default Description
base string optional "EUR" Code to convert from. pattern ^[A-Z]{3}$
symbols string optional none Targets, e.g. USD,GBP. pattern ^[A-Z]{3}(,[A-Z]{3}){0,19}$
date string required none Day, as YYYY-MM-DD. pattern ^\d{4}-\d{2}-\d{2}$

Output

A JSON object whose fields depend on the request; this tool declares no fixed shape.

Try it

Run this tool from your account, with a form built from the fields above. A run is a real call; this tool is free.

Open in the playground