AINumbers.co Medicare API

openapi: 3.2.0
info:
  title: AINumbers.co Fintech Intelligence Suite Medicare API
  version: 1.0.0
  description: '**1255 fintech intelligence tools** covering ISO 20022, A2A payments, CFPB §1033, EU AI Act, DORA, MiCA, AML/KYC, BaaS, DLT/tokenization, ESG/climate finance, agentic payments (AP2, ACP, x402, Visa TAP, Mastercard Agent Pay), PQC migration, sanctions screening, and OpenChainGraph v0.4 computation chains.


    ## Transport


    > **The live transport is MCP JSON-RPC 2.0 at `https://mcp.ainumbers.co/mcp` — not REST.**

    >

    > This OpenAPI file is a **descriptive data-room artifact** — a machine-readable index of all tools and their input/output schemas. The REST paths (`POST /v1/tools/{name}`) described here are a projection; they become functional only if the optional REST shim (Area 2 Path B) is deployed.

    >

    > To call tools today, connect via the official MCP client SDKs. TypeScript: `@modelcontextprotocol/sdk`. Python: `mcp`.


    ## Architecture


    All tools run **entirely client-side** (browser JavaScript). Zero PII. Zero server calls after page load. Deterministic, reproducible outputs. Licensed CC BY 4.0.


    OpenChainGraph v0.4 compute-binding nodes additionally run **server-side on the MCP Worker** and emit verifiable artifacts with `execution_hash` (WebCrypto SHA-256 over RFC 8785 canonical JSON).'
  contact:
    name: Post Oak Labs
    url: https://postoaklabs.com
    email: tim@postoaklabs.com
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://ainumbers.co
  description: Static browser-based tool host (DreamHost). Tools run client-side — no REST gateway is active on this origin. See x-mcp for the live MCP endpoint.
tags:
- name: Medicare
paths:
  /v1/tools/compute_m3p_monthly_cap:
    post:
      operationId: compute_m3p_monthly_cap
      summary: M3P Monthly Cap Calculator
      description: 'Recomputes the Medicare Prescription Payment Plan (M3P) maximum monthly cap under 42 CFR 423.137(c)(1)(i) (first month of participation) and (c)(1)(ii) (every subsequent month), verified by exhaustive enumeration over the full declared cents/months domain (4,830,023 states). The annual out-of-pocket threshold is a plan-year-indexed CMS figure, carried as a keyed, source-digested policy parameter rather than a bare constant -- CY2026 is $2,100. Rounding is declared half-up-to-the-cent, since the regulation states no explicit rounding rule for the division step; the declaration is backed by three independent CMS-sourced worked examples and implemented with exact integer arithmetic, never floating-point division. A caller-declared numerator or months value outside the declared domain is rejected with a named reason, never clamped or silently coerced. Verify-only: recomputes the formula from caller-declared inputs, does not track a real enrollee''s true out-of-pocket accumulation, does not enroll anyone in M3P, and does not assert that any actual participant''s bill is correct.


        **Tool URL:** https://ainumbers.co/tools/617-m3p-monthly-cap-calculator.html

        **AP2/Policy Mandate export:** yes'
      tags:
      - Medicare
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - branch
              - months_remaining
              properties:
                plan_year:
                  type: integer
                branch:
                  type: string
                  enum:
                  - first_month
                  - subsequent_month
                incurred_TrOOP_cents:
                  type: integer
                remaining_owed_cents:
                  type: integer
                newly_incurred_cents:
                  type: integer
                months_remaining:
                  type: integer
      responses:
        '200':
          description: Successful tool execution result
          content:
            application/json:
              schema:
                type: object
                properties:
                  valid_input:
                    type: boolean
                  domain_errors:
                    type: array
                    description: Named reasons the input was rejected, if any
                  numerator_cents:
                    type: integer
                  cap_cents:
                    type: integer
                  cap_dollars_display:
                    type: string
                  rounding_mode:
                    type: string
      x-mcp-tool-name: compute_m3p_monthly_cap
      x-tool-url: https://ainumbers.co/tools/617-m3p-monthly-cap-calculator.html
      x-source: manifest
      x-ap2-export: true
x-mcp:
  transport: MCP JSON-RPC 2.0 (streamable HTTP)
  endpoint: https://mcp.ainumbers.co/mcp
  protocol_version: '2025-11-25'
  authentication: none
  registry: co.ainumbers/tools (official MCP registry)
  note: Connect any MCP-compatible client (Claude, ChatGPT, custom agent) directly to this endpoint. The REST paths in this file are descriptive only — they do not exist on the live server unless the REST shim is deployed.