# MCP Servers, CLI & SDKs (MCPWire, Folio, Panas) — Carlos Rivera

Complete technical reference for the first-party **Model Context Protocol (MCP)** servers, CLI packages, and Streamable HTTP endpoints published by **Carlos Rivera** and the **MCPWire** organization.

- **Live MCP Discovery & Streamable HTTP Endpoint**: [https://carlosrivera.im/.well-known/mcp](https://carlosrivera.im/.well-known/mcp)
- **Static MCP Manifest Mirror**: [https://carlosrivera.im/.well-known/mcp.json](https://carlosrivera.im/.well-known/mcp.json)
- **API & Developer Documentation**: [https://carlosrivera.im/docs](https://carlosrivera.im/docs)
- **Official npm Package**: [`@mcpwire/cli`](https://www.npmjs.com/package/@mcpwire/cli)
- **GitHub Organizations**: [github.com/mcpwire](https://github.com/mcpwire) · [github.com/carlosrivera](https://github.com/carlosrivera)

## 1. Site MCP Server (`https://carlosrivera.im/.well-known/mcp`)

The endpoint at `https://carlosrivera.im/.well-known/mcp` serves an MCP discovery manifest via `GET` and implements the **MCP Streamable HTTP transport (JSON-RPC 2.0, protocol version `2025-03-26`)** via `POST`.

### Streamable HTTP `initialize` Handshake Example
```bash
curl -sS -X POST https://carlosrivera.im/.well-known/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": { "name": "example-agent", "version": "1.0.0" }
    }
  }'
```

### Tools Exposed at `/.well-known/mcp`
1. `get_profile`: Returns structured biographical data, engineering track record, companies founded/led (Meshi, Figuro, Synx), and advisory availability for Carlos Rivera.
2. `list_developer_tools`: Lists first-party MCP servers, CLIs, and developer products (`@mcpwire/cli`, Folio, Panas, Ocelo, Belio, bicio) with npm packages, stacks, and URLs.
3. `search_essays`: Searches bilingual (English and Spanish) technical essays on AI systems, agent infrastructure, and startup execution by keyword or tag.
4. `get_essay`: Fetches the full Markdown body and metadata of any essay by `slug` and `lang` (`en` or `es`).
5. `get_contact_and_engagement_info`: Returns verified contact details (`me@carlosrivera.im`) and fractional CTO / advisory engagement guidelines.

## 2. `@mcpwire/cli` — Encrypted P2P MCP Proxy & CLI

- **Product Homepage**: [https://mcpwire.co](https://mcpwire.co)
- **npm Package**: [`@mcpwire/cli`](https://www.npmjs.com/package/@mcpwire/cli)
- **GitHub Organization**: [https://github.com/mcpwire](https://github.com/mcpwire)
- **When to Use**: Share or consume local MCP servers between two machines over an encrypted peer-to-peer tunnel without opening firewall ports or exposing secret API keys.
- **MCP Client Configuration (`mcpServers`)**:

```json
{
  "mcpServers": {
    "mcpwire-peer": {
      "command": "npx",
      "args": ["-y", "@mcpwire/cli", "connect", "<SESSION_TICKET>"]
    }
  }
}
```

## 3. Folio MCP Server — Markdown-to-PDF Document Publisher

- **Product URL**: [https://carlosrivera.github.io/folio/](https://carlosrivera.github.io/folio/)
- **When to Use**: Convert agent-authored Markdown reports, architectural RFCs, tables, and KaTeX math into paginated, print-ready PDFs with automated layout linting.
- **Available MCP Tools**:
  - `folio_list_document_types`
  - `folio_get_document_type`
  - `folio_register_document_type`
  - `folio_create_document`
  - `folio_customize_document`
  - `folio_lint_document`
  - `folio_export_pdf`
  - `folio_list_styles`, `folio_create_style`, `folio_duplicate_style`, `folio_update_style`, `folio_apply_style`

## 4. Panas MCP Server — Peer-to-Peer Compute & Inference Market

- **Product URL**: [https://panas.mcpwire.co](https://panas.mcpwire.co)
- **When to Use**: Discover idle remote compute nodes, obtain signed price quotes, verify Solana USDC or test grants, and run sandboxed Docker inference or tool workloads over MCPWire.
- **Available MCP Tools**:
  - `discover_providers`, `get_provider`
  - `quote_inference`
  - `get_balance`, `create_funding_intent`, `confirm_funding`
  - `purchase_access`
  - `run_inference`
  - `get_request`, `cancel_request`