# 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

## Installation

1. Clone this repository:

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

2. Install uv if you haven't already:

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

3. Install dependencies:

```bash
uv sync
```

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

```bash
IOL_USER=your_username
IOL_PASS=your_password
```

## Configure Claude Desktop

1. Open Claude Desktop configuration directory:

```bash
open ~/Library/Application\ Support/Claude
```

2. Create or edit `claude_desktop_config.json`:

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

3. Add the following configuration:

```json
{
  "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:

```bash
pytest tests/test_client.py -v
```

For coverage report:

```bash
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.