{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "version": "1.0",
  "protocolVersion": "2026-07-28",
  "serverInfo": {
    "name": "milyo",
    "title": "Milyo",
    "version": "1.0.0"
  },
  "description": "Reconcile two files of transactions, convert CAMT.053 or MT940 to CSV, and on a paid plan work with an org's stored sources, rule sets, runs and exceptions.",
  "documentationUrl": "https://milyo.app/docs/mcp/",
  "transport": {
    "type": "streamable-http",
    "endpoint": "https://app.milyo.app/mcp"
  },
  "capabilities": {
    "tools": {}
  },
  "authentication": {
    "required": true,
    "schemes": [
      "bearer"
    ]
  },
  "instructions": "Create a key in the app: app.milyo.app, Settings, API keys. It is shown once. Free on any plan: parse_file, convert and reconcile (up to 100,000 rows a file, nothing stored, 100 calls a day). Every other tool needs a paid plan and answers plan_required. The paid app is in private beta.",
  "tools": [
    {
      "name": "convert",
      "description": "Turn a CAMT.053, MT940 or XLSX file into CSV text, every row as it is in the file. Free plan."
    },
    {
      "name": "create_rule_set",
      "description": "Add a rule set that reconciles source A against source B. Paid plan."
    },
    {
      "name": "create_source",
      "description": "Add a source, the place one kind of file comes from. Paid plan."
    },
    {
      "name": "download_set_aside",
      "description": "Download the rows an upload could not read, as CSV, with the problem in a last column. Paid plan."
    },
    {
      "name": "dry_run",
      "description": "Try passes on the open rows of the 7 days ending at the newest booked date, and return the counts. Paid plan."
    },
    {
      "name": "export_exceptions",
      "description": "Export the audit trail of the exception queue as one CSV, oldest first, for a rule set and a booked date range. Paid plan."
    },
    {
      "name": "get_exception",
      "description": "Get one exception: its rows from both sources (ids, dates, amounts, references), the difference, why it was flagged in the words of the rules, and its history across runs, with every resolve, write-off and note. Paid plan."
    },
    {
      "name": "get_mapping",
      "description": "Read a source's latest mapping, the rule for which column holds the date, amount, reference and so on. Paid plan."
    },
    {
      "name": "get_rule_set",
      "description": "Get a rule set with its latest saved passes, the rules in plain words, and the unit amount tolerances are written in. Paid plan."
    },
    {
      "name": "get_run",
      "description": "Get a run with its counts by pass and by reason, and a page of the matches it made. Paid plan."
    },
    {
      "name": "list_exceptions",
      "description": "List exceptions, newest first: the items that didn't match, each with its reason, status, difference and how many rows it holds on each side. Paid plan."
    },
    {
      "name": "list_rule_sets",
      "description": "List the org's rule sets, oldest first, each with its latest run, how many matches stand and its open exceptions by reason. Paid plan."
    },
    {
      "name": "list_runs",
      "description": "List a rule set's runs, newest first, with what started each, the rules version, how many rows it read, and its matches and exceptions. Paid plan."
    },
    {
      "name": "list_sources",
      "description": "List the org's sources, oldest first. Paid plan."
    },
    {
      "name": "list_uploads",
      "description": "List a source's uploads, newest first, with how many rows each read, added and set aside. Paid plan."
    },
    {
      "name": "match_rows",
      "description": "Match open rows by hand. Paid plan."
    },
    {
      "name": "parse_file",
      "description": "Read a file in memory and return its format, header, the first rows and a suggested mapping from columns to fields. Free plan."
    },
    {
      "name": "preview_mapping",
      "description": "Apply a mapping that is not saved yet to the source's latest upload and return the first rows it would read, and what it would set aside. Paid plan."
    },
    {
      "name": "reconcile",
      "description": "Match two files in memory and return counts, matches and the exceptions with the reason for each. Free plan."
    },
    {
      "name": "resolve_exception",
      "description": "Close an open exception with a reason code and a note. Paid plan."
    },
    {
      "name": "save_mapping",
      "description": "Save a mapping as the source's next version. Paid plan."
    },
    {
      "name": "save_rules",
      "description": "Save passes as the rule set's next version. Paid plan."
    },
    {
      "name": "start_run",
      "description": "Run the rule set's latest rules over every open row of its two sources, up to today, and wait for the result. Paid plan."
    },
    {
      "name": "unmatch",
      "description": "Undo a match, made by a run or by hand, with a note. Paid plan."
    },
    {
      "name": "upload_file",
      "description": "Read a file with the source's latest mapping and add its rows. Paid plan."
    }
  ]
}
