AINumbers.co PDF API

openapi: 3.2.0
info:
  title: AINumbers.co Fintech Intelligence Suite PDF 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: PDF
paths:
  /v1/tools/convert_pdf_to_docx_markdown:
    post:
      operationId: convert_pdf_to_docx_markdown
      summary: PDF to DOCX & Markdown Converter
      description: 'Converts the text layer of a PDF into a Markdown file and a DOCX file: column-aware reading order recovered by a band-first recursive XY-cut (full-width horizontal bands first, aligned table rows detected before any column split, then vertical gutters flanked by real text columns on both sides), font-size heading tiers plus all-caps section headings, paragraphs with end-of-line hyphens rejoined, bulleted and numbered lists, and best-effort tables. Detects and reports pages with no text layer, and flags pages whose text runs reach the right page boundary, instead of shipping silent clipping or empty output. Entirely client-side, zero network calls, pdf.js inlined workerless.


        **Tool URL:** https://ainumbers.co/tools/643-pdf-to-docx-markdown-converter.html'
      tags:
      - PDF
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - pdf_file
              properties:
                pdf_file:
                  type: string
                  format: binary
      responses:
        '200':
          description: Successful tool execution result
          content:
            application/json:
              schema:
                type: object
                properties:
                  markdown:
                    type: string
                  docx_base64:
                    type: string
                  scanned_pages:
                    type: array
                    items:
                      type: integer
                  input_sha256:
                    type: string
                  output_sha256_md:
                    type: string
                  output_sha256_docx:
                    type: string
                  pdfjs_version:
                    type: string
      x-mcp-tool-name: convert_pdf_to_docx_markdown
      x-tool-url: https://ainumbers.co/tools/643-pdf-to-docx-markdown-converter.html
      x-source: manifest
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.