# Carlos Rivera API y Documentación para Desarrolladores — MCPWire, Folio y Panas

Documentación técnica oficial de las APIs, servidores Model Context Protocol (MCP), herramientas CLI y endpoints legibles por máquina desarrollados por **Carlos Rivera**.

- **Referencia dedicada de servidores MCP y CLI**: [https://carlosrivera.im/es/mcp](https://carlosrivera.im/es/mcp) ([Markdown](https://carlosrivera.im/es/mcp.md))
- **Manifiesto y endpoint MCP Streamable HTTP**: [https://carlosrivera.im/.well-known/mcp](https://carlosrivera.im/.well-known/mcp)
- **Instrucciones para agentes (cuándo usar)**: [https://carlosrivera.im/agent-instructions.md](https://carlosrivera.im/agent-instructions.md)
- **Directorio LLM**: [https://carlosrivera.im/llms.txt](https://carlosrivera.im/llms.txt) · [https://carlosrivera.im/llms-full.txt](https://carlosrivera.im/llms-full.txt)
- **Organizaciones GitHub**: [github.com/carlosrivera](https://github.com/carlosrivera) · [github.com/mcpwire](https://github.com/mcpwire)

## 1. API de Contenido y Negociación Markdown (https://carlosrivera.im)

Todas las páginas públicas de `https://carlosrivera.im` soportan negociación de contenido en Markdown para agentes de IA y clientes HTTP, además de rutas estáticas `.md`:

```bash
# Solicitar la página principal en Markdown vía cabecera Accept
curl -sS -L -i -H 'Accept: text/markdown' https://carlosrivera.im/

# Solicitar directamente el artefacto Markdown equivalente
curl -sS -L https://carlosrivera.im/index.md
curl -sS -L https://carlosrivera.im/docs.md
curl -sS -L https://carlosrivera.im/mcp.md
```

### Endpoints públicos legibles por máquina
| Endpoint | Tipo de Contenido | Descripción |
| :--- | :--- | :--- |
| `/llms.txt` | `text/plain; charset=utf-8` | Índice estructurado para agentes con guía de casos de uso y enlaces canónicos |
| `/llms-full.txt` | `text/plain; charset=utf-8` | Corpus completo de herramientas, perfil y todos los ensayos técnicos en Markdown |
| `/agent-instructions.md` | `text/markdown; charset=utf-8` | Guía operativa detallada sobre cuándo y cómo un agente debe invocar cada herramienta |
| `/.well-known/mcp` | `application/json; charset=utf-8` | Manifiesto de servidor MCP y endpoint de transporte Streamable HTTP (JSON-RPC 2.0) |
| `/rss.xml` / `/es/rss.xml` | `application/rss+xml` | Feeds RSS 2.0 en inglés y español |
| `/sitemap-index.xml` | `application/xml` | Índice de sitemaps XML con enlaces `hreflang` |

## 2. MCPWire CLI y API de Proxy P2P (`@mcpwire/cli`)

**MCPWire** ([https://mcpwire.co](https://mcpwire.co) · [github.com/mcpwire](https://github.com/mcpwire)) es un proxy cifrado punto a punto para servidores Model Context Protocol (MCP). Permite exponer o consumir un servidor MCP local entre dos máquinas sin abrir puertos ni copiar claves privadas.

### Instalación y uso por CLI
```bash
# Ejecutar directamente con npx
npx -y @mcpwire/cli --help

# Exponer un servidor MCP local a un par autorizado mediante túnel cifrado
npx -y @mcpwire/cli share --command "node ./my-mcp-server.js"

# Conectarse a un servidor MCP compartido desde un cliente (Claude Desktop, Cursor, Codex, Antigravity)
npx -y @mcpwire/cli connect <invite-token>
```

## 3. Folio — API de Publicación Markdown a PDF y Servidor MCP

**Folio** ([https://carlosrivera.github.io/folio/](https://carlosrivera.github.io/folio/) · [github.com/carlosrivera/folio](https://github.com/carlosrivera/folio)) convierte archivos Markdown con tablas, diagramas y ecuaciones KaTeX en reportes PDF con paginación física real.

### Herramientas del Servidor MCP de Folio
- `folio_list_document_types`: Lista las plantillas y tipos de documentos disponibles (reportes ejecutivos, RFCs, propuestas).
- `folio_get_document_type`: Obtiene el esquema de metadatos requerido para un tipo de documento.
- `folio_register_document_type`: Registra un nuevo tipo de documento personalizado.
- `folio_create_document`: Crea un documento paginado a partir de contenido Markdown y metadatos.
- `folio_customize_document`: Ajusta márgenes, tamaño de página, encabezados y tipografía.
- `folio_lint_document`: Audita saltos de página, encabezados huérfanos, tablas desbordadas y enlaces rotos.
- `folio_export_pdf`: Compila y exporta el documento final en formato PDF listo para impresión o distribución.
- `folio_list_styles`, `folio_create_style`, `folio_duplicate_style`, `folio_update_style`, `folio_apply_style`: Gestión programática de temas tipográficos.

## 4. Panas — API MCP de Cómputo e Inferencia Peer-to-Peer

**Panas** ([https://panas.mcpwire.co](https://panas.mcpwire.co)) permite a agentes autónomos descubrir nodos con capacidad de cómputo disponible, cotizar precios fijos, verificar presupuestos firmados criptográficamente (incluyendo liquidación USDC en Solana) y ejecutar cargas en sandboxes Docker aislados sin red sobre túneles MCPWire.

### Herramientas del Servidor MCP de Panas
- `discover_providers` / `get_provider`: Descubre proveedores de cómputo activos, modelos soportados y precios.
- `quote_inference`: Obtiene una cotización firmada vinculada a un modelo, límites de tokens y precio máximo.
- `get_balance` / `create_funding_intent` / `confirm_funding`: Consulta saldo del agente y registra fondos en el libro contable.
- `purchase_access`: Emite una concesión criptográfica (grant) reservando el presupuesto para la ejecución.
- `run_inference`: Ejecuta la carga de trabajo a través del túnel cifrado MCPWire dentro del contenedor aislado del proveedor.
- `get_request` / `cancel_request`: Recupera resultados de forma idempotente ante desconexiones o cancela solicitudes pendientes.