IOL MCP Tool

A Model Context Protocol (MCP) tool for interacting with Invertir Online (IOL) API through Claude Desktop.

Prerequisites

• Claude Desktop App for Mac

• Python 3.8+

• IOL trading account

• Environment variables setup with your IOL credentials

Related MCP server: kiwoom-mcp

Installation

1. Clone this repository:

git clone https://github.com/fernandezpablo85/mcpiol.git
cd mcpiol

2. Install uv if you haven't already:

curl -LsSf https://astral.sh/uv/install.sh | sh

3. Install dependencies:

uv sync

4. Create a .env file in the project root with your IOL credentials:

IOL_USER=your_username
IOL_PASS=your_password

Configure Claude Desktop

1. Open Claude Desktop configuration directory:

open ~/Library/Application\ Support/Claude

2. Create or edit claude_desktop_config.json:

touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

3. Add the following configuration:

{
  "mcpServers": {
    "iol": {
      "command": "/Users/YOUR_USERNAME/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/YOUR_USERNAME/projects/playground/mcpiol",
        "run",
        "main.py"
      ]
    }
  }
}

Important notes:

• Replace YOUR_USERNAME with your actual username

• Both the command and --directory paths must be absolute paths

• You can find your uv installation path by running which uv in the terminal

Running Tests

To run the test suite:

pytest tests/test_client.py -v

For coverage report:

pytest tests/test_client.py --cov=client -v

Troubleshooting

1. If tools don't appear in Claude Desktop:

   • Verify your configuration file is correct

   • Restart Claude Desktop

   • Check Python path and dependencies

2. If authentication fails:

   • Verify your .env file exists and has correct credentials

   • Check IOL API status

   • Ensure your IOL account is active

License

MIT

Contributing

Feel free to open issues or submit pull requests.