Skip to main content
Glama
Sign In
argentina-markets-mcp

argentina-markets-mcp

by cris-devtrading
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

argentina-markets-mcp

An MCP server that exposes Argentine market data to AI agents, plus the building blocks for a paper-trading agent with deterministic risk guardrails and an auditable decision log.

Paper trading only. Not financial advice. Quotes come from a public third-party API and may be delayed or inaccurate.

Status

Early stage, solo project. What works today:

Component

What it does

Tests

get_dolar_quote tool

MEP, CCL, official, blue, wholesale, card and crypto dollar quotes via dolarapi.com (no API key)

yes

Audit log

@audited decorator writes one JSON line per tool call (timestamp, args, result or error, duration)

yes

Risk module

Kill switch, per-order cap, position cap (reducing a position is always allowed), data-freshness check

yes

Paper trading

simulate_order runs quote, freshness check, risk check and a simulated fill against an in-memory portfolio; rejections are logged too

yes

Not built yet: BYMA equities/options/bonds tools, a persistent portfolio, and a strategy/agent loop on top of these tools.

Related MCP server: latamfx-mcp

Quick start

Requires Python 3.10+ (developed and tested on 3.12).

git clone https://github.com/cris-devtrading/argentina-markets-mcp.git
cd argentina-markets-mcp
uv venv --python 3.12 && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest

Run the server over stdio:

python -m argentina_markets_mcp.server

Tools

  • ping: health check.

  • get_dolar_quote(tipo="mep"): returns buy/sell and the source timestamp. tipo accepts mep, ccl, oficial, blue, mayorista, tarjeta, cripto.

  • simulate_order(tipo, side, amount_ars): simulated buy/sell of USD against ARS. Buys fill at the ask, sells at the bid, no short positions. Returns filled or rejected with the reason.

  • get_paper_portfolio(): current simulated cash, USD and kill-switch state (in memory, resets on restart).

  • engage_kill_switch(reason): rejects all further orders. There is intentionally no tool to disengage it; restart the server.

Audit log

Every call to an audited tool appends a line to audit_log.jsonl (override with the AUDIT_LOG_PATH environment variable). The file is git-ignored. A logging failure never breaks the tool.

Risk guardrails

risk.py contains pure, network-free functions, so they are easy to test:

  • KillSwitch: when engaged, every order is rejected.

  • check_order: rejects orders above the per-order cap, and orders that would push a position above its cap unless they reduce it.

  • check_data_fresh: rejects stale or invalid quote timestamps.

The default limits in RiskLimits are placeholders, not recommendations. Configure them for your own case.

Secrets

No credentials belong in this repo. Copy .env.example to .env (git-ignored) for local settings.

License

MIT

Available Tools

5 tools
engage_kill_switchC

Activa el kill switch: rechaza todas las órdenes siguientes.

Inputs: reason (required).

get_dolar_quoteA

Cotización del dólar en Argentina (compra/venta).

tipo: mep, ccl, oficial, blue, mayorista, tarjeta o cripto. Solo informa cotizaciones; no es asesoramiento financiero.

Inputs: tipo.

get_paper_portfolioB

Estado de la cartera simulada (en memoria; se reinicia con el servidor).

Inputs: no named parameters.

pingA

Health check.

Inputs: no named parameters. Returns: result

simulate_orderA

Orden simulada (paper trading) de compra/venta de USD contra ARS.

side: 'buy' o 'sell'. amount_ars: monto en pesos, positivo. Pasa por los guardrails (kill switch, topes, frescura del dato). Devuelve status 'filled' o 'rejected' con el motivo.

Inputs: side (required), tipo (required), amount_ars (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: health check, dollar quote retrieval, simulated order placement, portfolio inspection, and kill-switch activation. The only interaction is that the kill switch affects future orders, but the boundary between the tools remains clear.

    Naming Consistency4/5

    The core tools use readable snake_case verb_noun naming such as get_dolar_quote, simulate_order, and engage_kill_switch. The lone ping tool is a minor deviation from the pattern but does not create confusion.

    Tool Count5/5

    Five tools is well-scoped for a small Argentina markets and paper-trading server. Each tool earns its place without excessive surface area.

    Completeness3/5

    The server covers quote retrieval, simulated order placement, portfolio state, and kill-switch activation, but it lacks a way to disengage or reset the kill switch. Once engaged, all future orders are permanently rejected until server restart, creating a notable dead end. Order history or portfolio reset operations are also absent.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • dolar-mcp

      dan1d
      A
      license
      A
      quality
      C
      maintenance
      Real-time Argentine exchange rates for AI agents. Dollar blue, oficial, MEP, CCL, crypto rates plus currency conversion and spread calculator.
      6
      10 npm
      5
      MIT

    • latamfx-mcp

      floreskemec
      A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to query public Latin American FX rates and perform auditable ledger reconciliation using a multi-rule matching engine.
      6
      MIT