Labsco
MCP SERVER

IOL MCP Tool

by fernandezpablo85

A local bridge from Claude Desktop to the Invertir Online API, authenticated with your own IOL account credentials.

Trading Execution & Brokerage
Summary
Your broker login, on your own machine, nowhere else.

This is a personal-scale bridge: one account, one laptop, credentials in a local file. That is the honest shape of it, and it is also the reason it is worth a look for anyone who trades through IOL and would rather ask a question than log in. Because it authenticates with the account password rather than a scoped token, the credentials in that `.env` are the whole account — worth deciding deliberately before you write them down.

What it is

A small MCP server that connects Claude Desktop on macOS to the API of Invertir Online, the Argentine broker, using the credentials of an account you already hold. It runs locally from a checkout, with the credentials in a `.env` file that never leaves the machine.

What you get

Your IOL account reachable from the assistant window instead of the broker's web platform. The server authenticates with your own login and talks to the IOL API on your behalf; the repository ships a test suite against the client so you can check the connection independently of the assistant (`pytest tests/test_client.py -v`, with coverage via `--cov=client`).

Requirements

An active IOL trading account, and its username and password in a `.env` file in the project root as `IOL_USER` and `IOL_PASS`. Claude Desktop for Mac, Python 3.8+ and the uv package manager; `uv sync` installs the dependencies. The client entry runs `uv` with `--directory` pointing at the repository and `main.py` as the target — both the `command` and the `--directory` value must be absolute paths, and `which uv` gives you the first one. The pyproject name is `mcpiol` (0.1.0), MIT licensed.