markjkaem/aifais-mcp-server

AIFAIS MCP Server

Document intelligence tools for AI agents. Pay-per-use via X402 protocol on Solana.

Overview

AIFAIS provides headless document processing APIs designed for autonomous AI agents. No API keys, no accounts — just pay per call using Solana.

Available Tools:

Quick Start

Connect via MCP Config

Add to your MCP client configuration (Claude Desktop, etc.):

{
  "mcpServers": {
    "aifais": {
      "url": "https://aifais.com/api/mcp",
      "transport": "sse"
    }
  }
}

Direct API Usage

# 1. Discover available tools
curl https://aifais.com/api/mcp

# 2. Call a tool (with payment proof)
curl -X POST https://aifais.com/api/agent/scan \
  -H "Content-Type: application/json" \
  -d '{
    "invoiceBase64": "<base64_encoded_file>",
    "mimeType": "application/pdf",
    "signature": "<solana_tx_signature>"
  }'

Payment Flow (X402)

1. Call tool without payment → Server returns 402 Payment Required
2. Response includes: price, recipient wallet, memo
3. Agent pays via Solana (SOL or USDC)
4. Retry with proof → Include signature in request
5. Server verifies on-chain → Returns result

Agent                          AIFAIS                         Solana
  |                              |                              |
  |-- POST /api/agent/scan ----->|                              |
  |<-- 402 Payment Required -----|                              |
  |                              |                              |
  |-- Transfer 0.001 SOL --------|----------------------------->|
  |<-- Transaction signature ----|------------------------------|
  |                              |                              |
  |-- POST /api/agent/scan ----->|                              |
  |   (with signature)           |-- Verify tx --------------->|
  |                              |<-- Confirmed ----------------|
  |<-- 200 OK + JSON result -----|                              |

Tool Schemas

scan_invoice

Extracts structured data from invoices.

Input:

{
  "invoiceBase64": "string (required) - Base64 encoded file",
  "mimeType": "string (required) - image/jpeg | image/png | application/pdf",
  "signature": "string (required) - Solana transaction signature"
}

Output:

{
  "success": true,
  "data": {
    "vendor": "Acme B.V.",
    "invoiceNumber": "INV-2024-001",
    "date": "2024-12-01",
    "total": 1250.00,
    "vat": 262.50,
    "currency": "EUR",
    "kvkNumber": "12345678",
    "lineItems": [...]
  }
}

analyze_contract (Coming Soon)

Analyzes contracts for risks and unfavorable clauses.

Input:

{
  "fileBase64": "string (required) - Base64 encoded PDF",
  "contractType": "string (optional) - nda | employment | supplier | lease",
  "focusAreas": "array (optional) - ['termination', 'liability', 'ip']",
  "signature": "string (required) - Solana transaction signature"
}

verify_business (Coming Soon)

Verifies Dutch businesses against official registries.

Input:

{
  "kvkNumber": "string (required) - 8-digit KvK number",
  "checks": "array (optional) - ['kvk', 'btw', 'bankruptcy']",
  "signature": "string (required) - Solana transaction signature"
}

Payment Details

Network: Solana Mainnet
Accepted: SOL, USDC
Wallet: [YOUR_WALLET_ADDRESS]

Prices are per API call. No subscriptions, no minimums.

Error Handling

Links

• Website: aifais.com
• Tools (Browser): aifais.com/tools
• API Endpoint: aifais.com/api/mcp

About AIFAIS

AIFAIS builds autonomous document processing agents for Dutch SMEs. We combine AI, blockchain, and automation to create digital workers that handle repetitive tasks.

Based in Gouda, Netherlands.

License

MIT