AINumbers.co GENIUS Act API

The GENIUS Act API from AINumbers.co — 4 operation(s) for genius act.

Operations 4

POST /v1/tools/genius_act_reserve_optimizer GENIUS Act Reserve Composition Optimizer #
POST /v1/tools/classify_genius_act_issuer GENIUS Act Payment Stablecoin Issuer Classification & Licensing Mapper #
POST /v1/tools/generate_reserve_attestation_checklist GENIUS Act Monthly Reserve Attestation & Disclosure Requirements Checklist #
POST /v1/tools/build_genius_act_aml_scope GENIUS Act AML & Sanctions Program Scope Builder #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/ainumbers-co:ainumbers-co-genius-act-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ainumbers-co-genius-act-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AINumbers.co Fintech Intelligence Suite GENIUS Act 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: GENIUS Act
paths:
  /v1/tools/genius_act_reserve_optimizer:
    post:
      operationId: genius_act_reserve_optimizer
      summary: GENIUS Act Reserve Composition Optimizer
      description: 'Validates and optimises payment stablecoin reserve composition against GENIUS Act (enacted Jul 2025, effective Jan 2027) requirements. Checks 1:1 backing, UST maturity caps (≤93 days), Fed deposit allocation, asset segregation, and monthly disclosure obligations. Outputs AP2 compliance mandate.


        **Tool URL:** https://ainumbers.co/tools/328-genius-act-reserve-optimizer.html

        **AP2/Policy Mandate export:** yes'
      tags:
      - GENIUS Act
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                issuer_type:
                  type: string
                outstanding_usd:
                  type: number
                reserves:
                  type: object
              required:
              - issuer_type
              - outstanding_usd
              - reserves
      responses:
        '200':
          description: Successful tool execution result
          content:
            application/json:
              schema:
                type: object
                properties:
                  compliance_score_pct:
                    type: number
                  backing_ratio:
                    type: number
                  ust_maturity_compliant:
                    type: boolean
                  gaps:
                    type: array
                    items:
                      type: string
                  verdict:
                    type: string
      x-mcp-tool-name: genius_act_reserve_optimizer
      x-tool-url: https://ainumbers.co/tools/328-genius-act-reserve-optimizer.html
      x-source: manifest
      x-ap2-export: true
  /v1/tools/classify_genius_act_issuer:
    post:
      operationId: classify_genius_act_issuer
      summary: GENIUS Act Payment Stablecoin Issuer Classification & Licensing Mapper
      description: 'Classifies a payment stablecoin issuer under the GENIUS Act framework (enacted July 18, 2025; effective January 18, 2027) and maps the applicable federal or state licensing pathway. Covers federally-chartered banks, state-licensed entities, insured depository institutions, and the $10B threshold for mandatory federal oversight.


        **Tool URL:** https://ainumbers.co/tools/336-genius-act-issuer-classification-mapper.html

        **AP2/Policy Mandate export:** yes'
      tags:
      - GENIUS Act
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                entity_type:
                  type: string
                  description: Charter/entity type of the issuer
                  enum:
                  - national_bank
                  - federal_savings
                  - state_bank_fed
                  - state_bank_fdic
                  - federal_credit_union
                  - state_credit_union
                  - money_transmitter
                  - new_entrant
                  - fbo
                  - foreign_nonbank
                outstanding_usd:
                  type: number
                  description: Outstanding payment stablecoins in USD
                total_assets_usd:
                  type: number
                  description: Total consolidated assets in USD
                already_regulated:
                  type: string
                  description: 'Already supervised by federal banking regulator: yes | no'
              required:
              - entity_type
              - outstanding_usd
      responses:
        '200':
          description: Successful tool execution result
          content:
            application/json:
              schema:
                type: object
                properties:
                  pathway_class:
                    type: string
                    enum:
                    - federal
                    - state
                    - foreign
                    description: Determined PPSI licensing pathway
                  primary_regulator:
                    type: string
                    description: Primary federal or state regulator
                  license_type:
                    type: string
                    description: Applicable PPSI license category
                  exceeds_10b_threshold:
                    type: boolean
                    description: Whether outstanding stablecoins exceed $10B mandatory federal oversight threshold
                  ppsi_checklist:
                    type: array
                    items:
                      type: object
                    description: PPSI qualification requirement checks
                  timeline_milestones:
                    type: array
                    items:
                      type: object
                    description: Licensing timeline milestones
      x-mcp-tool-name: classify_genius_act_issuer
      x-tool-url: https://ainumbers.co/tools/336-genius-act-issuer-classification-mapper.html
      x-source: manifest
      x-ap2-export: true
  /v1/tools/generate_reserve_attestation_checklist:
    post:
      operationId: generate_reserve_attestation_checklist
      summary: GENIUS Act Monthly Reserve Attestation & Disclosure Requirements Checklist
      description: 'Generates a monthly reserve attestation and disclosure compliance checklist for permitted payment stablecoin issuers (PPSIs) per GENIUS Act §6. Covers the 1:1 reserve requirement, eligible asset composition, PCAOB-registered accounting firm examination obligations, public disclosure format, redemption policy publication, and the 15-business-day cure window for reserve shortfalls.


        **Tool URL:** https://ainumbers.co/tools/337-genius-act-reserve-attestation-checklist.html

        **AP2/Policy Mandate export:** yes'
      tags:
      - GENIUS Act
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                outstanding_usd:
                  type: number
                  description: Total outstanding stablecoins in USD
                reserves_total_usd:
                  type: number
                  description: Total reserve assets held in USD
                non_qualifying_pct:
                  type: number
                  description: 'Percentage of reserves in non-qualifying assets (target: 0)'
                pcaob_engaged:
                  type: string
                  enum:
                  - 'yes'
                  - pending
                  - 'no'
                  description: PCAOB firm engagement status
                cure_window_active:
                  type: string
                  enum:
                  - 'yes'
                  - 'no'
                  description: Whether a shortfall cure window is active
                cure_days_elapsed:
                  type: integer
                  description: Business days elapsed in cure window (max 15)
              required:
              - outstanding_usd
              - reserves_total_usd
      responses:
        '200':
          description: Successful tool execution result
          content:
            application/json:
              schema:
                type: object
                properties:
                  verdict:
                    type: string
                    enum:
                    - compliant
                    - cure
                    - non-compliant
                    description: Overall attestation compliance verdict
                  coverage_ratio_pct:
                    type: number
                    description: 'Reserve coverage ratio as percentage (target: ≥100%)'
                  surplus_usd:
                    type: number
                    description: Reserve surplus (positive) or shortfall (negative) in USD
                  disclosure_checklist:
                    type: array
                    items:
                      type: object
                    description: 14-item monthly disclosure checklist with pass/fail status
                  open_items:
                    type: array
                    items:
                      type: string
                    description: Disclosure checklist items that failed
                  cure_window:
                    type: object
                    description: Cure window status if shortfall detected
                    properties:
                      active:
                        type: boolean
                      days_elapsed:
                        type: integer
                      days_remaining:
                        type: integer
                      expired:
                        type: boolean
                      statutory_window_days:
                        type: integer
                  pcaob_checklist:
                    type: array
                    items:
                      type: object
                    description: PCAOB examination requirement checklist
      x-mcp-tool-name: generate_reserve_attestation_checklist
      x-tool-url: https://ainumbers.co/tools/337-genius-act-reserve-attestation-checklist.html
      x-source: manifest
      x-ap2-export: true
  /v1/tools/build_genius_act_aml_scope:
    post:
      operationId: build_genius_act_aml_scope
      summary: GENIUS Act AML & Sanctions Program Scope Builder
      description: 'Builds the AML/BSA compliance program scope for PPSIs per GENIUS Act §10 and Treasury''s April 2026 proposed AML/sanctions rule. Covers BSA registration, CIP/CDD, transaction monitoring thresholds, OFAC screening, Travel Rule ($3,000 threshold), and SAR filing triggers.


        **Tool URL:** https://ainumbers.co/tools/338-genius-act-aml-sanctions-scope-builder.html

        **AP2/Policy Mandate export:** yes'
      tags:
      - GENIUS Act
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                monthly_volume_usd:
                  type: number
                  description: Monthly transaction volume in USD
                avg_transaction_usd:
                  type: number
                  description: Average transaction size in USD
                blockchain_type:
                  type: string
                  enum:
                  - public
                  - permissioned
                  - private
                  - multi
                existing_aml_program:
                  type: string
                  enum:
                  - 'yes'
                  - partial
                  - 'no'
                pct_cross_border:
                  type: number
                  description: Cross-border transaction percentage
              required:
              - monthly_volume_usd
              - blockchain_type
              - existing_aml_program
      responses:
        '200':
          description: Successful tool execution result
          content:
            application/json:
              schema:
                type: object
                properties:
                  verdict:
                    type: string
                    enum:
                    - full
                    - partial
                    - gap
                  bsa_category:
                    type: string
                  travel_rule_applies:
                    type: boolean
                  open_gaps:
                    type: array
                    items:
                      type: string
                  sar_trigger_matrix:
                    type: array
                    items:
                      type: object
                  required_program_components:
                    type: array
                    items:
                      type: string
      x-mcp-tool-name: build_genius_act_aml_scope
      x-tool-url: https://ainumbers.co/tools/338-genius-act-aml-sanctions-scope-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.