Live · MCP-native · OpenAPI-documented

Fintech Intelligence Suite
Developer Documentation

590 browser-based fintech tools by Post Oak Labs: MCP-native, OpenAPI-documented. 721 are live on the MCP endpoint, reachable via Python & TypeScript using the official MCP client SDKs. Zero server. Zero PII. CC BY 4.0.

721Live MCP Tools
v0.4OpenChainGraph
0Server Calls
CC BY 4.0License

Integration overview

AINumbers.co is an MCP-native, OpenAPI-documented fintech intelligence suite with 590 deterministic tools (721 live on the MCP endpoint) covering payments, compliance, AML/KYC, capital markets, ESG, and agentic finance. All tools run entirely client-side (zero server, zero PII, zero ops cost) with a live MCP JSON-RPC endpoint at https://mcp.ainumbers.co/mcp reachable by any MCP-compatible agent (Claude, ChatGPT, custom agents).

Python and TypeScript reachable today via official MCP client SDKs (see snippets below). Machine-readable index: openapi.json (OpenAPI 3.1: 1208 documented operations, 721 live on the MCP endpoint, flagged x-mcp-live). OpenChainGraph v0.4 nodes emit verifiable artifacts with cryptographic execution hashes (WebCrypto SHA-256, RFC 8785 canonical).

MCP-native OpenAPI-documented Python + TS via MCP SDK Zero server Zero PII CC BY 4.0 Not REST-accessible OpenAPI = descriptive artifact

Tool Catalog

All tools sourced from mcp/catalog.json; count derived at build time, never hardcoded. Each entry links to the interactive tool page. Connect via MCP to invoke programmatically.

Showing – tools

MCP name Description Category
Loading catalog…

Connect via MCP SDK

Use the official MCP client SDKs to connect directly to https://mcp.ainumbers.co/mcp. No auth. No install beyond the SDK itself. The OpenAPI file at ainumbers.co/openapi.json documents all inputs/outputs, but the live transport is MCP JSON-RPC, not REST.

TypeScript: @modelcontextprotocol/sdk
// npm install @modelcontextprotocol/sdk
import { Client } from '@modelcontextprotocol/sdk/client/index.js'
import { StreamableHTTPClientTransport } from
  '@modelcontextprotocol/sdk/client/streamableHttp.js'

const client = new Client({ name: 'my-agent', version: '1.0.0' })
const transport = new StreamableHTTPClientTransport(
  new URL('https://mcp.ainumbers.co/mcp')
)
await client.connect(transport)

// List all available tools
const { tools } = await client.listTools()
console.log(`Available: ${tools.length} tools`)

// Call a tool — e.g. calculate_xva (CVA/DVA calculator)
const result = await client.callTool({
  name: 'calculate_xva',
  arguments: {
    notional:      10_000_000,
    maturity_yrs:  5,
    credit_spread: 0.012,
    recovery_rate: 0.4,
    risk_free_rate:0.045
  }
})
console.log(result.content[0].text)

await client.close()
Python: mcp
# pip install mcp
import asyncio
from mcp.client.session import ClientSession
from mcp.client.streamable_http import streamablehttp_client

MCP_URL = "https://mcp.ainumbers.co/mcp"

async def main():
    async with streamablehttp_client(MCP_URL) as (r, w, _):
        async with ClientSession(r, w) as session:
            await session.initialize()

            # List all available tools
            tools = await session.list_tools()
            print(f"Available: {len(tools.tools)} tools")

            # Call a tool — e.g. score_credit_default_risk
            result = await session.call_tool(
                "score_credit_default_risk",
                arguments={
                    "annual_revenue": 5_000_000,
                    "debt_ratio":     0.42,
                    "years_trading":  8,
                    "sector":         "manufacturing"
                }
            )
            print(result.content[0].text)

asyncio.run(main())

Discovery → invoke → export flow

1 · tools/list

Call list_ainumbers_tools with a keyword query to find relevant tools. Returns prefill deep-links and metadata for up to 20 tools per query.

2 · tools/call

Invoke any tool by its mcp_name with typed inputs. Deterministic JSON response. ChainGraph nodes return a verifiable OpenChainGraph v0.4 artifact with execution_hash.

3 · Policy Mandate export

Tools with ap2_export: true emit an AINumbers Policy Mandate JSON, a structured compliance artifact with mandate_type, payload, agent_instructions, and audit metadata. Chain mandates across tools using the AIN Bridge prefill protocol.

4 · Verify execution hash

ChainGraph artifact hashes are independently verifiable. Recompute WebCrypto SHA-256 over RFC 8785 canonical JSON of {policy_parameters, output_payload} and compare. Verify at chaingraph/verify.html ↗

MCP endpoint details
Endpointhttps://mcp.ainumbers.co/mcp
TransportStreamable HTTP (MCP JSON-RPC 2.0, protocol version 2025-11-25)
AuthNone: public, no API key required
Registryco.ainumbers/tools (official MCP registry)
Rate limit50 req / 10s per IP (Cloudflare WAF rule; throttle to ~1.5 s/req for bulk calls)

API Reference

Note: The REST paths below are a descriptive projection: they describe every tool's input/output schema in OpenAPI format, but do not correspond to live REST routes. The live transport is MCP JSON-RPC at https://mcp.ainumbers.co/mcp. Use the SDK snippets above to call tools today. Raw spec: openapi.json ↗

1.6 MB, loads on demand