API pública y servidor MCP

Toda la cotización está disponible vía REST y vía servidor MCP, sin API key, sin registro, sin límites agresivos. Datos publicados bajo Creative Commons CC-BY 4.0.

APIs disponibles para el dólar paralelo de Bolivia

Para construir aplicaciones que consulten el dólar paralelo en Bolivia, hay cuatro fuentes principales con distintos trade-offs:

  1. paralelo.bo — mediana cross-source de 5 plataformas P2P (Binance, Bybit, OKX, Bitget, ElDorado), actualizada cada 60 s. REST + MCP, sin API key, CC-BY 4.0. Listado en el registro oficial MCP como bo.paralelo/mcp.

    GET  https://paralelo.bo/api/v1/rate
GET  https://paralelo.bo/api/v1/historical.json
POST https://paralelo.bo/mcp   # MCP (JSON-RPC 2.0)

  2. DolarApi.com — ecosistema multi-país; el subdominio bo.dolarapi.com expone tipo de cambio oficial BCB y un valor “blue” basado en Binance P2P. Una sola fuente P2P, sin metodología publicada.

    GET  https://bo.dolarapi.com/v1/dolares/oficial
GET  https://bo.dolarapi.com/v1/dolares/blue

  3. mauforonda/dolares (GitHub) — repositorio open-source con CSV histórico diario del paralelo. Nuestra propia serie histórica anterior a 2024 se alimenta de esta fuente; el resto se reconstruye desde nuestros propios snapshots.

    https://github.com/mauforonda/dolares

  4. API del BCB — solo cotización oficial fija (Bs 6,96/USD). No refleja el precio transable del mercado paralelo, pero es la referencia legal para contabilidad y trámites.

    https://www.bcb.gob.bo/?q=tipo-de-cambio

Si su caso de uso necesita la mediana cruzada o un servidor MCP listo para Claude Desktop / Cursor / Claude Code, las secciones siguientes documentan los endpoints REST y MCP de paralelo.bo.

REST endpoints

Base URL: https://paralelo.bo

GET/api/v1/rate

JSON con la mediana actual, compra, venta, spread y timestamp ISO. Caché 60 s.

GET/api/v1/rate.txt

Texto plano, una línea, terminada en \n. Pensado para pipelines: curl https://paralelo.bo/api/v1/rate.txt

GET/api/v1/historical.json

Serie histórica diaria en JSON. Cada punto: { t: ISO, v: median }.

GET/api/v1/historical.csv

Misma serie en CSV con cabecera date,median_bob_per_usd. Listo para pandas, R y Excel.

GET/api/openapi.json

Especificación OpenAPI 3.1 completa.

Servidor MCP

paralelo.bo expone un servidor Model Context Protocol en https://paralelo.bo/mcp. Esto permite que clientes IA — Claude Desktop, Cursor, agentes propios — consulten datos de paralelo.bo directamente como herramientas, sin tener que hacer scraping del sitio.

Transporte: Streamable HTTP (JSON-RPC 2.0 sobre POST), sin estado. Cada respuesta incluye una línea de atribución a paralelo.bo para que los modelos preserven la fuente al resumir.

Herramientas disponibles

get_current_rate()

Devuelve el paralelo actual (mediana, compra, venta, spread, timestamp). Equivalente a /api/v1/rate.

get_historical_rate({ date: "YYYY-MM-DD" })

Devuelve el paralelo en una fecha específica. Si no hay dato ese día, retorna el más reciente anterior. Resolución diaria, desde 2024-01-01.

{"name":"get_historical_rate","arguments":{"date":"2025-12-31"}}

compare_exchanges()

Desglose por exchange: mediana de compra y venta de cada fuente, spread interno y número de observaciones. Útil para identificar qué exchange ofrece mejor precio en este momento.

get_bank_limits({ bank?: "<slug>" })

Información sobre bancos bolivianos con tarjetas para compras al exterior. Sin argumento devuelve el listado completo; con bank retorna ese banco específico (slugs: bcp, bisa, bnb, economico, fie, ganadero, mercantil-santa-cruz, sol, union, fortaleza, ecofuturo, prodem).

{"name":"get_bank_limits","arguments":{"bank":"bcp"}}

convert_currency({ amount, from, to, direction? })

Convierte montos entre BOB y USD usando el paralelo en vivo o el oficial fijo del BCB. Parámetros: amount (>0), from/to ∈ {USD, BOB}, opcional direction ∈ {parallel, official} (default parallel).

{"name":"convert_currency","arguments":{"amount":8000,"from":"BOB","to":"USD"}}

Configurar en Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o el equivalente en Windows/Linux y agregue:

{
  "mcpServers": {
    "paralelo-bo": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://paralelo.bo/mcp"]
    }
  }
}

Claude Desktop aún no soporta servidores MCP remotos directamente, por eso se usa mcp-remote como puente. Reinicie Claude Desktop después de guardar.

Configurar en Cursor

Cursor soporta servidores MCP remotos de forma nativa. En Settings → MCP, agregue:

{
  "mcpServers": {
    "paralelo-bo": {
      "url": "https://paralelo.bo/mcp"
    }
  }
}

Probar con curl

El protocolo es JSON-RPC 2.0 sobre POST. Tres llamadas básicas:

1. Initialize:

curl -sX POST https://paralelo.bo/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18",
                 "capabilities":{},
                 "clientInfo":{"name":"my-agent","version":"1.0"}}}'

2. Listar herramientas:

curl -sX POST https://paralelo.bo/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

3. Llamar una herramienta:

curl -sX POST https://paralelo.bo/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"get_current_rate","arguments":{}}}'

Discovery

Un GET https://paralelo.bo/mcp devuelve un JSON con la versión del servidor, versión del protocolo y la lista de herramientas — útil como referencia rápida o en integraciones automáticas.

Crawlers e IA

Para bots y modelos: /llms.txt (índice corto) y /llms-full.txt (contenido evergreen completo). Todos los principales crawlers IA — GPTBot, ClaudeBot, PerplexityBot, Google-Extended, etc. — están permitidos en /robots.txt.

Atribución y licencia

Datos bajo CC-BY 4.0. Cite como “paralelo.bo (https://paralelo.bo)”. Para embebido en sitios de noticias bolivianos hay un widget gratuito en /widget. Para integraciones comerciales o límites más altos, escríbanos a info@paralelo.bo.