Alpaca
Interact with the Alpaca trading API for stock trading, market data, and account management.Read full description
miguelyad26LABSCO 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.
Setup effort
Build from source — git clone https://github.com/fernandezpablo85/mcpiol.git
USE CASES
01
Reaching an IOL account from a chat window
Put your credentials in the local .env, point Claude Desktop at the checkout, and ask about the account instead of opening the broker's site.
02
Confirming the connection works before trusting it
Run the included client tests to see whether authentication and the API calls succeed, separately from whether the assistant is wired up right.
BEFORE YOU INSTALL
What to know first
Requires
- Python 3.8+
- IOL_PASS in your environment
- IOL_USER in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/fernandezpablo85/mcpiol.git
cd mcpiol
curl -LsSf https://astral.sh/uv/install.sh | sh # only if uv is not installed yet
uv syncCreate a .env file in the project root with IOL_USER=<YOUR_IOL_USER> and IOL_PASS=<YOUR_IOL_PASS>
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"iol": {
"command": "/Users/<YOUR_USERNAME>/.local/bin/uv",
"args": [
"--directory",
"/Users/<YOUR_USERNAME>/projects/playground/mcpiol",
"run",
"main.py"
]
}
}
}The configuration on this page does not set IOL_PASS and IOL_USER; the project's instructions put them in a .env file. Check which folder the server reads that file from before you rely on it.
