AINumbers.co Pillar 3 API

openapi: 3.2.0
info:
  title: AINumbers.co Fintech Intelligence Suite Pillar 3 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: pillar-3
paths:
  /v1/tools/pillar_3_disclosure_builder:
    post:
      operationId: pillar_3_disclosure_builder
      summary: Pillar 3 Disclosure Builder
      description: 'Assemble Basel III Pillar 3 disclosure tables per BCBS 309 (March 2017) and BCBS 400 (December 2018). Generates KM1 (key metrics), OV1 (overview of RWAs by risk type), LIQ1 (LCR detail), and LIQ2 (NSFR detail). Consumes outputs from T201 (RWA), T469 (LCR), T470 (NSFR), T471 (leverage ratio). Verify row definitions against EBA ITS (EU) or PRA rules (UK). Tier 1 Policy Mandate JSON + Markdown. Client-side. Works offline. Zero PII.


        **Tool URL:** https://ainumbers.co/tools/472-pillar-3-disclosure-builder.html

        **AP2/Policy Mandate export:** yes'
      tags:
      - pillar-3
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                bank_name:
                  type: string
                period:
                  type: string
                cet1_ratio:
                  type: number
                  description: CET1 ratio %
                t1_ratio:
                  type: number
                tc_ratio:
                  type: number
                rwa:
                  type: number
                  description: Total RWA (m)
                lr_pct:
                  type: number
                  description: Leverage ratio %
                lcr_pct:
                  type: number
                  description: LCR %
                nsfr_pct:
                  type: number
                  description: NSFR %
                cr_rwa:
                  type: number
                mr_rwa:
                  type: number
                or_rwa:
                  type: number
                hqla_m:
                  type: number
                gross_out:
                  type: number
                net_inf:
                  type: number
                nco:
                  type: number
                asf_m:
                  type: number
                rsf_m:
                  type: number
              required:
              - cet1_ratio
              - t1_ratio
              - tc_ratio
              - rwa
              - lcr_pct
              - nsfr_pct
              - lr_pct
      responses:
        '200':
          description: Successful tool execution result
          content:
            application/json:
              schema:
                type: object
                properties:
                  km1:
                    type: object
                    description: KM1 key metrics table
                  ov1:
                    type: object
                    description: OV1 RWA overview table
                  liq1:
                    type: object
                    description: LIQ1 LCR detail table
                  liq2:
                    type: object
                    description: LIQ2 NSFR detail table
      x-mcp-tool-name: pillar_3_disclosure_builder
      x-tool-url: https://ainumbers.co/tools/472-pillar-3-disclosure-builder.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.