Financial Evidence

Herramientas MCP de solo lectura para enrutar y ensamblar evidencia financiera pública de LiquiLens, Undertow, Seiche y Palimpsest.

GitHubPrueba este MCPPatrocinado

Documentación

Habilidades del Agente de Evidencia Financiera

skills.sh

La documentación pública incluye una matriz de integración rastreable, además de llms.txt legible por agentes, precios, metadatos de integración y un registro de marketplace de terceros con fecha. El contrato semántico v0.1.5 define el estado solo-transporte, los metadatos de adaptadores reportados por la fuente y el límite explícito de no-Carrier. La versión 0.1.5 es una versión firmada y verificada de forma independiente. Sus instalaciones versionadas de Agent Skill, terminal, Codex, Gemini, editor y bundle usan la misma versión, con artefactos publicados, contenedor, registro en Registry y fórmula de Homebrew. El comando de marketplace autoalojado de Claude sigue la rama predeterminada mutable del repositorio; revisa el commit verificado antes de habilitarlo.

Habilidades de agente abiertas y de solo lectura para enrutar investigación financiera hacia evidencia pública acotada. La primera habilidad conecta cuatro productos complementarios sin convertirlos en una sola puntuación:

  • Seiche — mercados monetarios, repo, reservas, efectivo del Tesoro y financiamiento del sistema.
  • LiquiLens — evidencia cubierta de bancos y prestamistas.
  • Undertow — profundidad de mercado, concentración de proveedores y liquidez de salida según tamaño de posición.
  • Palimpsest — evidencia económica de China a prueba de revisiones e historial de estado de información.

Para un flujo de trabajo diario de investigación, Market Brief proporciona resúmenes gratuitos con citas de fuentes sobre financiamiento, mercados de capital y liquidez, con comparaciones de cambios locales. Este compañero de navegador y habilidad de agente, versionado por separado, usa las fuentes de evidencia pública existentes.

Instalar la habilidad de agente

npx skills add https://github.com/beepboop2025/financial-evidence-skills/tree/v0.1.5/financial-evidence \
  --skill financial-evidence

O copia financial-evidence/ en el directorio de Agent Skills compatible con tu agente. La carpeta sigue la especificación abierta de Agent Skills.

La habilidad también está indexada en el directorio público skills.sh.

Una vez instalada, pide a tu agente que investigue una pregunta sobre mercados monetarios, mercados de capital, riesgo bancario, liquidez de mercado o economía de China. La descripción de la habilidad permite que agentes compatibles la activen cuando el trabajo coincide.

Uso desde cualquier terminal

No se requiere cuenta ni clave de API. En macOS o Linux con Homebrew:

brew install beepboop2025/tap/financial-evidence
financial-evidence fetch --topic money-market --topic china-economy

La fórmula instala financial-evidence, financial-evidence-mcp y las completaciones nativas para Bash, Zsh y Fish. Alternativamente, ejecútalo directamente desde GitHub sin instalarlo:

uvx --from git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.5 \
  financial-evidence fetch --topic money-market --topic china-economy

O instálalo como un comando persistente:

uv tool install git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.5
financial-evidence topics
financial-evidence route --topic capital-market --format table
financial-evidence fetch --topic bank-risk --format ndjson
financial-evidence doctor --format csv

El código de salida 0 significa que se recuperó cada fuente solicitada, 1 significa que el transporte fue parcial y 2 significa que cada fuente solicitada no estuvo disponible. El paquete heredado status se conserva y equivale a transport_status; ambos significan solo alcance de transporte. Cada paquete indica status_semantics: transport_only, evidence_status: not_evaluated y carrier_verification: not_performed. Eso hace que el cliente sea seguro para componer en pipelines de shell sin confundir un éxito HTTP con evidencia validada o un Evidence Carrier verificado. JSON, NDJSON y CSV van a la salida estándar; ningún resultado se reemplaza silenciosamente con una puntuación.

Fuera de Homebrew, las completaciones de shell se emiten como texto inerte:

financial-evidence completion zsh > ~/.zfunc/_financial-evidence

Uso como infraestructura MCP

El endpoint público Streamable HTTP no requiere instalación local, cuenta ni clave de API:

https://liquilens.in/mcp/financial-evidence

Expone las mismas tres herramientas de solo lectura topics, route y fetch para clientes que admiten MCP remoto. La raíz .mcp.json es la configuración de plugin portátil para ese remoto público:

{
  "mcpServers": {
    "financial-evidence": {
      "type": "http",
      "url": "https://liquilens.in/mcp/financial-evidence"
    }
  }
}

El paquete también incluye un servidor stdio sin dependencias para configuraciones de clientes locales o compatibles sin conexión. Su configuración fija está en integrations/mcp-config.json. Ambos transportes aceptan el flujo de inicialización MCP 2025-11-25 y el flujo de descubrimiento sin estado 2026-07-28. Los mensajes locales de stdio usan JSON-RPC delimitado por líneas; nada excepto los mensajes de protocolo se escribe en la salida estándar.

El registro oficial de MCP Registry publica tanto el paquete OCI de múltiples arquitecturas como el endpoint público Streamable HTTP. Los clientes remotos no necesitan uv, Docker, una credencial ni un subproceso local.

Instalar en Gemini CLI o Claude Code

Gemini CLI puede instalar este repositorio como una extensión. Su raíz gemini-extension.json se conecta solo al endpoint remoto público MCP fijo y permite las tres herramientas de solo lectura; la carpeta reflejada skills/financial-evidence le da a Gemini las instrucciones de enrutamiento de dominio también:

gemini extensions install https://github.com/beepboop2025/financial-evidence-skills \
  --ref v0.1.5

Claude Code puede agregar este repositorio como un marketplace autoalojado e instalar el plugin incluido:

claude plugin marketplace add beepboop2025/financial-evidence-skills
claude plugin install financial-evidence@liquidity-lab

Este comando de Claude sigue la rama predeterminada mutable. Revisa el commit verificado antes de habilitar el plugin; las rutas de instalación versionadas anteriores permanecen fijas a la versión verificada.

El plugin de Claude carga la misma Agent Skill byte-idéntica más el servidor remoto público .mcp.json raíz. Estas son rutas de instalación directas y autoalojadas; no implican inclusión en un marketplace operado por un proveedor ni respaldo.

Instalar en Codex; preparar ChatGPT

Codex puede agregar el marketplace de plugins del repositorio y luego instalar el plugin:

codex plugin marketplace add beepboop2025/financial-evidence-skills --ref v0.1.5
codex plugin add financial-evidence@liquidity-lab

El paquete de plugin de OpenAI combina la Agent Skill byte-idéntica con el endpoint MCP remoto público. La ruta de instalación del repositorio de Codex es pública. También está preparado un envío al directorio universal de ChatGPT y Codex, pero no ha sido enviado, aprobado ni publicado por OpenAI. Los pasos restantes de revisión, identidad del editor y desafío de dominio pertenecen al propietario de la cuenta de OpenAI. Consulta OPENAI_PLUGIN_SUBMISSION.md para la copia del listado y las pruebas positivas y negativas requeridas.

La raíz .mcp.json es la forma de plugin portátil para el servidor MCP remoto público. VS Code y Cursor conservan archivos de espacio de trabajo separados para el servidor stdio local fijo, por lo que las instalaciones de plugin no dependen de un proceso local de Python mientras los espacios de trabajo del editor aún pueden usar uno.

Instalar en VS Code o Cursor

El repositorio también incluye configuración de espacio de trabajo específica del editor: .vscode/mcp.json usa el objeto de nivel superior servers de VS Code, mientras que .cursor/mcp.json usa el objeto de nivel superior mcpServers de Cursor. Los enlaces de instalación públicos actualmente lanzan el servidor stdio verificado v0.1.5 a través de uvx, coincidiendo con los manifiestos del repositorio.

VS Code puede instalar el servidor a través de su manejador de protocolo:

vscode:mcp/install?%7B%22name%22%3A%22financial-evidence%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22git%2Bhttps%3A%2F%2Fgithub.com%2Fbeepboop2025%2Ffinancial-evidence-skills.git%40v0.1.5%22%2C%22financial-evidence-mcp%22%5D%7D

O agrégalo a tu perfil de usuario de VS Code desde una terminal:

code --add-mcp '{"name":"financial-evidence","type":"stdio","command":"uvx","args":["--from","git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.5","financial-evidence-mcp"]}'

Cursor puede instalar la misma configuración a través de su deeplink codificado en base64:

cursor://anysphere.cursor-deeplink/mcp/install?name=financial-evidence&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2JlZXBib29wMjAyNS9maW5hbmNpYWwtZXZpZGVuY2Utc2tpbGxzLmdpdEB2MC4xLjUiLCJmaW5hbmNpYWwtZXZpZGVuY2UtbWNwIl19

Instala uv primero para que uvx esté en tu PATH. Revisa el código fuente y la configuración exacta antes de aceptar el aviso de instalación o confianza de un editor: uvx ejecuta el paquete fijo localmente, y la herramienta fetch puede contactar las fuentes HTTPS públicas fijas documentadas por este proyecto. Cursor solicita aprobación de herramientas de forma predeterminada. VS Code normalmente te pide confiar en un servidor cuando se inicia por primera vez, pero iniciar directamente desde mcp.json puede omitir ese aviso, así que inspecciona el archivo antes de usar su acción de inicio en línea. Estos son artefactos de compatibilidad autoinstalables, no afirmaciones de un listado o respaldo de marketplace de VS Code o Cursor.

Para clientes de escritorio que admiten MCP Bundles de un clic, descarga financial-evidence-0.1.5.mcpb de la última versión verificada de GitHub. El bundle usa el runtime multiplataforma uv y no requiere clave de API ni configuración.

Integraciones de herramientas financieras

  • MCP remoto: conecta cualquier cliente Streamable HTTP a https://liquilens.in/mcp/financial-evidence; no se requiere runtime local, cuenta ni clave de API.
  • Gemini CLI: el manifiesto de extensión raíz incluye la Agent Skill y permite las tres herramientas expuestas por el endpoint MCP remoto público.
  • Claude Code: el marketplace autoalojado liquidity-lab instala el plugin versionado, la Agent Skill y la configuración MCP desde este repositorio.
  • Codex: el marketplace del repositorio instala la Agent Skill y el paquete MCP remoto público directamente.
  • ChatGPT: el paquete de envío al directorio universal está preparado; la disponibilidad pública sigue pendiente de verificación, envío, revisión y publicación por parte de la cuenta.
  • OpenBB: instala financial-evidence[openbb] desde este repositorio dentro de un entorno OpenBB y ejecuta openbb-build. El router registrado expone obb.financial_evidence.routes() y obb.financial_evidence.fetch(), que también están disponibles en las superficies REST, notebook y MCP de OpenBB.
  • DuckDB: ejecuta integrations/duckdb/financial_evidence.sql para crear vistas separadas respaldadas por HTTP para los cuatro productos.
  • Excel / Power Query: pega integrations/excel/FinancialEvidence.pq en el Editor Avanzado e invoca, por ejemplo, FinancialEvidence("money-market").
  • FDC3: el Financial Evidence Inspector público recibe y transmite contextos estándar declarados a través de window.fdc3. integrations/fdc3/appd-record.json es su registro de aplicación web FDC3 2.0 para directorios autoalojados o empresariales. El mismo registro se sirve como JSON sin procesar para ingesta directa en directorios. El registro y el runtime no implican revisión de FINOS, aceptación en directorios ni respaldo de proveedores.
  • Contenedores: las versiones etiquetadas publican una imagen de múltiples arquitecturas en ghcr.io/beepboop2025/financial-evidence-skills. La imagen ejecuta stdio MCP de forma predeterminada; usa --entrypoint financial-evidence para comandos de terminal.
  • Registro oficial de MCP: las imágenes etiquetadas se publican bajo io.github.beepboop2025/financial-evidence usando GitHub OIDC y la anotación de propiedad de la imagen. No se almacena ninguna credencial de registro de larga duración.

Integridad de versiones

Cada versión etiquetada reconstruye y vuelve a probar los contratos de Python y JavaScript desde el commit firmado exacto main antes de la publicación. La versión adjunta una wheel, un archivo fuente, un bundle MCP, un SBOM CycloneDX y SHA256SUMS; las atestaciones de procedencia de compilación de GitHub Sigstore vinculan cada artefacto descargable al flujo de trabajo de la versión. Los consumidores pueden verificar un artefacto con gh attestation verify contra beepboop2025/financial-evidence-skills.

Recuperación acotada opcional

El asistente incluido usa solo la biblioteca estándar de Python, acepta una lista fija de temas y obtiene solo endpoints HTTPS públicos fijos:

python3 financial-evidence/scripts/fetch_evidence.py \
  --topic money-market --topic china-economy

Devuelve un paquete JSON con URLs de fuente exactas y resueltas, URLs canónicas de alcance humano, relojes de recuperación, conteos de bytes, valores SHA-256 de contenido, documentos de producto separados y errores explícitos. Las respuestas exitosas también incluyen solo el estado de fuente específico del endpoint y los relojes nombrados por adaptadores explícitos, con rutas RFC 6901 y procedencia de bytes obtenidos; los campos configurados faltantes son not_reported. El router no infiere frescura, elegibilidad ni derechos. Las rutas declaran financial_authority: none y carrier_state: not_published, y por lo tanto no exponen ningún carrier_url. Las redirecciones se rechazan antes de seguirlas. El JSON devuelto son datos de evidencia no confiables, no instrucciones ejecutables. La evidencia faltante, restringida o no disponible nunca se convierte en cero o "calma".

Límites

Este repositorio proporciona enrutamiento de investigación pública, no asesoramiento de inversión, recomendaciones de seguridad, cotizaciones de ejecución, calificaciones crediticias ni garantías. Los editores de fuentes conservan sus derechos; un asistente de código abierto no vuelve a licenciar los datos ascendentes.

Soporte · Privacidad · Términos

Desarrollo

python3 -m unittest discover -s tests -v
python3 -m py_compile financial-evidence/scripts/fetch_evidence.py src/financial_evidence/*.py

El código y las instrucciones de la habilidad están bajo licencia MIT.