convez.ai
MCP ServerFinanceiroAvançado
Chralt98

Event Contract Builder MCP

Chralt98/event-contract-builder

Gera contratos estruturados para mercados de previsão com validação automática

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP em TypeScript para gerar e validar especificações de contratos de eventos em YAML e JSON para mercados de previsão. Inclui biblioteca, CLI e validação de critérios de resolução, fontes de dados e políticas de ambiguidade para contratos estruturados.

Instalação

$npx convez-ai Chralt98/event-contract-builder

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 6 dias
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Definir critérios de resolução para apostas condicionais em mercados de previsão
  • Validar especificações de contratos de eventos contra schema estruturado
  • Converter entre formatos YAML e JSON de contratos de previsão
  • Documentar fontes de dados e políticas de ambiguidade em contratos

Veredito

Ferramenta especializada e bem-estruturada para um nicho técnico (mercados de previsão). Em desenvolvimento ativo, com API que pode mudar; útil para quem trabalha com contratos inteligentes e previsões estruturadas, mas requer domínio do domínio.

README

A tradução para o português deste README ainda está na fila.

event-contract-builder

A TypeScript library, CLI, and MCP server for generating, validating, and converting YAML and JSON event contract specifications for prediction markets.

Status

This package is in early development. The public API may change before v1.0.0.

The library entry point is available through the package root after building:

bun run build

Installation

npm install event-contract-builder

Usage

Render a canonical statement from structured resolution fields:

import {
  EventContractSpec,
  renderCanonicalStatement,
  type EventContractSpecT,
} from "event-contract-builder";

const spec: EventContractSpecT = {
  dsl: "event-contract-cnl/0.1",
  resolution: {
    criterion: {
      kind: "threshold",
      metric: {
        name: "US CPI year-over-year rate",
        unit: "percent",
        extraction: "Read the annual percent change from the CPI publication.",
        revisionPolicy: "first-published-value",
      },
      comparator: "greater-than-or-equal",
      threshold: 3,
    },
    canonicalStatement: "",
    observationWindow: {
      start: "2026-01-01T00:00:00Z",
      end: "2026-12-31T23:59:59Z",
      timezone: "UTC",
    },
    sources: [
      {
        id: "bls-cpi",
        name: "Consumer Price Index",
        publisher: "U.S. Bureau of Labor Statistics",
        url: "https://www.bls.gov/cpi/",
        publicationSchedule: "Published monthly by the BLS.",
        publiclyAccessible: true,
        independenceNote: "The publisher is a government statistics agency.",
      },
    ],
    primarySourceId: "bls-cpi",
    fallbacks: [],
    resolutionDeadline: "2027-01-31T23:59:59Z",
    earlyResolution: { allowed: false },
    terminalAmbiguityPolicy: "void-and-refund",
    edgeCases: [
      {
        scenario: "If the source retracts the first value before the deadline.",
        disposition: "Use the corrected value published before the deadline.",
      },
      {
        scenario: "If no value is published before the deadline.",
        disposition: "Apply the terminal ambiguity policy.",
      },
      {
        scenario: "If the dataset is renamed without method changes.",
        disposition: "Use the renamed successor dataset.",
      },
    ],
    disputeWindowHours: 24,
  },
};

const canonicalStatement = renderCanonicalStatement(spec);
const validatedSpec = EventContractSpec.parse({
  ...spec,
  resolution: {
    ...spec.resolution,
    canonicalStatement,
  },
});

console.log(validatedSpec.resolution.canonicalStatement);

Disclaimer

See DISCLAIMER.md for important information about the legal and regulatory status of outputs produced by this tooling.

License

Copyright © 2026 Christopher Maximilian Altmann. Licensed under the Apache License, Version 2.0.

Ver o original no GitHub

Bom para

Relacionados