Amalgix AI API

Artificial Intelligence tools

Operations 4

POST /mcp Financial Filing and Contract Intelligence via MCP #
POST /api/v1/analyze Document Evidence Analysis #
POST /api/v1/filings/analyze Financial Filing Intelligence #
POST /api/v1/contracts/review Contract Risk Intelligence #

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/amalgix-io:amalgix-io-ai-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

amalgix-io-ai-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Amalgix Io AI API
  version: 1.1.0
  x-guidance: All tools are accessed via POST /mcp using MCP JSON-RPC 2.0. Use analyze_public_filing for SEC/public filing workflows and review_contract_risks for contracts. Dynamic pricing from $0.03 based on document size and request complexity, scaling up to a $79 hard safety ceiling. Use estimate_cost (FREE) before paid calls. Optional wallet login/API keys identify dashboard and REST usage; paid execution still uses x402.
  x-logo:
    url: https://amalgix.io/assets/logo-x402-tight.png
    altText: Amalgix Logo
  x-payment-protocol: x402
  description: 'Operations tagged AI across 2 of this provider''s published API definitions: amalgix-io-openapi.json, status-amalgix-io-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /
tags:
- name: AI
  description: Artificial Intelligence tools
paths:
  /mcp:
    post:
      tags:
      - AI
      summary: Financial Filing and Contract Intelligence via MCP
      operationId: mcpEndpoint
      description: 'Crucible™ Evidence Engine via JSON-RPC 2.0 MCP endpoint. Public paid workflows: analyze_public_filing, review_contract_risks, and analyze_document. Legacy utility tools remain MCP-compatible but are not public REST products.'
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '0.030000'
          max: '79.000000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: AI agent service for filing, contract, and evidence workflows. Accepts JSON-RPC 2.0 requests for MCP tool calls.
              properties:
                jsonrpc:
                  type: string
                  enum:
                  - '2.0'
                  description: JSON-RPC version
                id:
                  type:
                  - string
                  - integer
                  description: Request ID
                method:
                  type: string
                  enum:
                  - tools/call
                  - tools/list
                  - initialize
                  - ping
                  description: MCP method for AI agent interaction
                params:
                  type: object
                  properties:
                    name:
                      type: string
                      enum:
                      - analyze_public_filing
                      - review_contract_risks
                      - analyze_document
                      - extract_web
                      - summarize
                      - delegate_bulk_translate
                      - estimate_cost
                      - health_check
                      description: MCP tool name. Public paid tools are filing, contract, and general evidence analysis; utility tools are retained for MCP compatibility.
                    arguments:
                      type: object
                      description: AI tool-specific arguments
                  required:
                  - name
              required:
              - jsonrpc
              - method
      responses:
        '200':
          description: Success — JSON-RPC 2.0 response with tool results
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id:
                    type:
                    - string
                    - integer
                  result:
                    type: object
        '402':
          description: Payment Required
        '429':
          description: Rate limited
        '503':
          description: Service at capacity
    servers:
    - url: /
  /api/v1/analyze:
    post:
      tags:
      - AI
      summary: Document Evidence Analysis
      operationId: analyzeDocument
      description: General Crucible™ evidence analysis. Returns source-grounded findings with evidence snippets, source references, confidence scores, and verification status.
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '0.030000'
          max: '79.000000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: AI analysis request — send document content and analysis query
              properties:
                content:
                  type: string
                  description: Full document text or Base64 file to analyze (max 20MB)
                query:
                  type: string
                  description: Analysis question or focus area
                analysisType:
                  type: string
                  enum:
                  - auto
                  - general_evidence
                  - financial_filing
                  - contract_review
                  description: Optional Crucible analysis mode
                fileUrl:
                  type: string
                  description: Optional HTTPS file URL to download and analyze
                format:
                  type: string
                  enum:
                  - auto
                  - text
                  - pdf
                  - docx
                  - xlsx
                  - csv
                  - html
                  description: 'Force input format. Default: auto-detect'
                sourceType:
                  type: string
                  enum:
                  - text
                  - file_url
                  - upload_base64
                  - public_url
                  - ticker
                  description: Source type metadata for routing
                ticker:
                  type: string
                  description: Company ticker symbol for financial filing context
                partyPerspective:
                  type: string
                  enum:
                  - buyer
                  - seller
                  - vendor
                  - customer
                  - neutral
                  description: 'Review perspective. Default: neutral'
                jurisdiction:
                  type: string
                  description: Jurisdiction metadata for contract review context
              required:
              - query
      responses:
        '200':
          description: AI analysis results with structured findings
          content:
            application/json:
              schema:
                type: object
                properties:
                  analysis:
                    type: object
                    properties:
                      summary:
                        type: string
                        description: Executive summary of findings
                      evidenceFindings:
                        type: array
                        items:
                          type: object
                          properties:
                            claim:
                              type: string
                            evidence:
                              type: string
                            sourceRef:
                              type: string
                            confidence:
                              type: string
                              enum:
                              - high
                              - medium
                              - low
                            verificationStatus:
                              type: string
                        description: Ranked source-grounded findings
                      overallConfidence:
                        type: string
                        enum:
                        - high
                        - medium
                        - low
                  meta:
                    type: object
                    properties:
                      chunksProcessed:
                        type: integer
                        description: Number of document chunks processed
                      latencyMs:
                        type: integer
                        description: Processing time in milliseconds
                      estimatedCost:
                        type: number
                        description: Estimated internal API cost in USD (not the x402 charge)
        '402':
          description: Payment Required
    servers:
    - url: /
  /api/v1/filings/analyze:
    post:
      tags:
      - AI
      summary: Financial Filing Intelligence
      operationId: analyzePublicFiling
      description: Crucible™ Financial Filing Intelligence for public filings. Accepts content, filingUrl, or SEC ticker/CIK lookup for 10-K, 10-Q, and 20-F filings. Returns metrics, risk changes, contradictions, management tone, missing information, evidence, confidence, and not-investment-advice.
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '0.030000'
          max: '79.000000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ticker:
                  type: string
                  description: Ticker symbol for SEC lookup, e.g. AAPL
                cik:
                  type: string
                  description: SEC CIK alternative to ticker
                form:
                  type: string
                  enum:
                  - 10-K
                  - 10-Q
                  - 20-F
                  description: 'SEC filing form. Default: 10-K'
                year:
                  type: integer
                  description: Filing/report year. Omit for latest matching filing
                filingUrl:
                  type: string
                  description: Optional public filing URL
                content:
                  type: string
                  description: Optional uploaded or preprocessed filing text
                depth:
                  type: string
                  enum:
                  - quick
                  - standard
                  - deep
                  description: 'Analysis depth. Default: standard'
                question:
                  type: string
                  description: Optional focus question
      responses:
        '200':
          description: Financial filing intelligence with evidence-backed findings
          content:
            application/json:
              schema:
                type: object
                properties:
                  analysis:
                    type: object
                    properties:
                      metrics:
                        type: array
                        items:
                          type: object
                        description: Key financial metrics extracted with source references
                      risk_changes:
                        type: array
                        items:
                          type: object
                        description: Risk factor changes between periods with evidence
                      contradictions:
                        type: array
                        items:
                          type: object
                        description: Internal contradictions detected in the filing
                      management_tone:
                        type: object
                        description: Management sentiment analysis with evidence
                      missing_information:
                        type: array
                        items:
                          type: string
                        description: Expected disclosures not found in the filing
                      evidence:
                        type: array
                        items:
                          type: object
                          properties:
                            claim:
                              type: string
                            evidence:
                              type: string
                            sourceRef:
                              type: string
                            confidence:
                              type: string
                              enum:
                              - high
                              - medium
                              - low
                            verificationStatus:
                              type: string
                        description: Source-grounded evidence findings
                      confidence:
                        type: string
                        enum:
                        - high
                        - medium
                        - low
                      not_investment_advice:
                        type: boolean
                  meta:
                    type: object
                    properties:
                      engine:
                        type: string
                      workflow:
                        type: string
                      filing:
                        type: object
        '402':
          description: Payment Required
    servers:
    - url: /
  /api/v1/contracts/review:
    post:
      tags:
      - AI
      summary: Contract Risk Intelligence
      operationId: reviewContractRisks
      description: Crucible™ review for contracts, MSAs, NDAs, procurement agreements, and compliance documents. Returns risk clauses, obligations, deadlines, liability exposure, missing terms, unusual clauses, evidence, and human-review flags. Not legal advice.
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '0.030000'
          max: '79.000000'
        protocols:
        - x402: {}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                content:
                  type: string
                  description: Contract text or Base64 document content
                fileUrl:
                  type: string
                  description: Optional HTTPS URL to a public contract/document file
                query:
                  type: string
                  description: Optional focus area. Default reviews payment, termination, liability, confidentiality, jurisdiction, renewal, obligations, deadlines, missing terms
                contractType:
                  type: string
                  enum:
                  - nda
                  - msa
                  - saas
                  - procurement
                  - lease
                  - employment
                  - other
                  description: Contract type hint
                jurisdiction:
                  type: string
                  description: Optional jurisdiction metadata
                depth:
                  type: string
                  enum:
                  - quick
                  - standard
                  - deep
                  description: 'Analysis depth. Default: standard'
                focus:
                  type: string
                  description: Optional focus area
                format:
                  type: string
                  enum:
                  - auto
                  - text
                  - pdf
                  - docx
                  - xlsx
                  - csv
                  - html
                  description: 'Force input format. Default: auto'
                partyPerspective:
                  type: string
                  enum:
                  - buyer
                  - seller
                  - vendor
                  - customer
                  - neutral
                  description: 'Review perspective. Default: neutral'
                sourceType:
                  type: string
                  enum:
                  - text
                  - file_url
                  - upload_base64
                  - public_url
                  description: Source type metadata
      responses:
        '200':
          description: Contract risk intelligence with source-grounded review flags
          content:
            application/json:
              schema:
                type: object
                properties:
                  analysis:
                    type: object
                    properties:
                      contract_type:
                        type: string
                        description: Detected contract type
                      parties:
                        type: array
                        items:
                          type: object
                        description: Identified contract parties
                      dates:
                        type: array
                        items:
                          type: object
                        description: Key dates and deadlines
                      commercial_terms:
                        type: array
                        items:
                          type: object
                        description: Commercial terms and pricing
                      obligations:
                        type: array
                        items:
                          type: object
                        description: Party obligations with deadlines
                      risk_flags:
                        type: array
                        items:
                          type: object
                        description: Identified risk clauses with severity
                      missing_clauses:
                        type: array
                        items:
                          type: object
                        description: Expected clauses not found
                      unusual_terms:
                        type: array
                        items:
                          type: object
                        description: Non-standard or unusual clauses
                      evidence:
                        type: array
                        items:
                          type: object
                          properties:
                            claim:
                              type: string
                            evidence:
                              type: string
                            sourceRef:
                              type: string
                            confidence:
                              type: string
                              enum:
                              - high
                              - medium
                              - low
                            verificationStatus:
                              type: string
                        description: Source-grounded evidence findings
                      confidence:
                        type: string
                        enum:
                        - high
                        - medium
                        - low
                      not_legal_advice:
                        type: boolean
                  meta:
                    type: object
                    properties:
                      engine:
                        type: string
                      workflow:
                        type: string
                      contract:
                        type: object
        '402':
          description: Payment Required
    servers:
    - url: /
x-refined-from:
- amalgix-io-openapi.json
- status-amalgix-io-openapi.json