Rafid Intelligence Network

{
  "name": "Rafid Intelligence Network",
  "description": "Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.",
  "url": "https://api.rafidsystem.com",
  "provider": {
    "organization": "Rafid"
  },
  "distribution": {
    "ampersend": {
      "enabled": true,
      "status": "READY",
      "marketplace": "https://app.ampersend.ai/discover",
      "manifest": "https://api.rafidsystem.com/api/v1/distribution/ampersend",
      "statusMeaning": "Technical package readiness only; deployment, submission, listing and paid verification require separate evidence.",
      "capabilities": [
        "document_facts_extract",
        "invoice_anomaly_check",
        "shipping_cost_estimate",
        "analyze_property",
        "compare_properties",
        "estimate_maintenance"
      ]
    }
  },
  "version": "0.1.3",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "authentication": {
    "schemes": [
      "x402",
      "l402",
      "mpp",
      "apiKey",
      "bearer"
    ]
  },
  "payments": {
    "x402": true,
    "l402": true,
    "mpp": {
      "enabled": true,
      "modes": [
        "charge",
        "session"
      ],
      "info": "/api/v1/mpp",
      "status": "/api/v1/mpp/status",
      "chargeMethods": [
        "tempo/charge"
      ],
      "sessionMethod": "tempo/session",
      "network": "tempo-testnet",
      "authorization": "Authorization: Payment <credential>"
    },
    "apiCredits": true,
    "subscription": true,
    "methods": [
      "x402",
      "api_credits",
      "subscription",
      "l402",
      "mpp"
    ],
    "discovery": "/api/v1/payment-methods"
  },
  "paymentMethods": "/api/v1/payment-methods",
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "analyze_company_risk",
      "name": "analyze_company_risk",
      "description": "Gather evidence-tiered risk signals for a company across corporate identity, domain, website, sanctions-list name-matching, adverse news, reputation and legal/regulatory signals \u2014 never a safe/unsafe verdict.",
      "tags": [
        "pre-transaction risk screening",
        "vendor/partner risk check",
        "sanctions name-matching indicator",
        "adverse media / reputation check"
      ],
      "selection": {
        "toolRole": "specialized",
        "selectionPriority": 30,
        "intents": [
          "pre-transaction risk screening",
          "vendor/partner risk check",
          "sanctions name-matching indicator",
          "adverse media / reputation check"
        ],
        "recommendedFor": [
          "Use when an agent needs risk evidence to weigh before a transaction, partnership, or onboarding decision \u2014 not a substitute for compliance/legal sign-off."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"company\":\"Acme Corporation\",\"website\":\"https://acme.example.com\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.35,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/intelligence/analyze-company-risk",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "analyze_oman_company",
      "name": "analyze_oman_company",
      "description": "Generate deterministic commercial-intelligence signals, risk flags and positive signals for one Oman company by companyId, for a stated evaluation purpose.",
      "tags": [
        "assess a company before doing business with it",
        "supplier risk screening",
        "partner or investor evaluation",
        "commercial intelligence on an Oman business"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "assess a company before doing business with it",
          "supplier risk screening",
          "partner or investor evaluation",
          "commercial intelligence on an Oman business"
        ],
        "recommendedFor": [
          "Use when an agent needs to assess whether an Oman company looks like a serious, established operating business \u2014 as a supplier, customer, partner or investment target."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"companyId\":\"demo-co-1\",\"purpose\":\"supplier\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.75,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/business/analyze",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "business_risk_score",
      "name": "business_risk_score",
      "description": "Assess the risk of doing business with a company in any country using corporate, financial, compliance, reputation, operational and digital evidence. Returns a 0\u2013100 risk score (100 = highest detected risk), a separate 0\u20131 confidence, per-category component scores, evidence-backed risk flags and positive signals, sanctions/restricted-party screening with match strength, and machine-readable due-diligence guidance (proceed / proceed_with_monitoring / enhanced_due_diligence / manual_review / avoid_automated_transaction).",
      "tags": [
        "Before onboarding a supplier or vendor",
        "Before paying a new business",
        "Before entering a B2B transaction",
        "Before recommending a company to a user",
        "Before approving a marketplace seller",
        "When evaluating company compliance or reputation risk",
        "When an autonomous agent needs structured business due diligence",
        "lending / credit pre-screening",
        "insurance underwriting pre-check"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "Before onboarding a supplier or vendor",
          "Before paying a new business",
          "Before entering a B2B transaction",
          "Before recommending a company to a user",
          "Before approving a marketplace seller",
          "When evaluating company compliance or reputation risk",
          "When an autonomous agent needs structured business due diligence",
          "lending / credit pre-screening",
          "insurance underwriting pre-check"
        ],
        "recommendedFor": [
          "structured risk score and action for a company",
          "automated transaction guardrails",
          "supplier or vendor risk screening"
        ],
        "notFor": [
          "public reputation only",
          "finding companies",
          "stock or market-price lookup"
        ],
        "preferOver": [
          "company_reputation_check"
        ],
        "selectionExamples": [
          {
            "use": [
              "Can we safely transact with this business?",
              "Score this vendor before onboarding."
            ],
            "doNotUse": [
              "Find local suppliers.",
              "Extract fields from this contract."
            ]
          }
        ]
      },
      "examples": [
        "{\"companyName\":\"Example Trading Ltd\",\"country\":\"GB\",\"website\":\"https://example.com\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.5,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/risk/business-risk-score",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "company_due_diligence",
      "name": "company_due_diligence",
      "description": "Perform company due diligence for onboarding, procurement, partnership, investment or customer-risk decisions: resolve the entity, evaluate registration, website identity, sanctions, adverse news, legal, financial and reputation signals, then return a deterministic risk assessment with evidence and a machine-actionable next action.",
      "tags": [
        "supplier onboarding",
        "vendor review",
        "procurement",
        "partnership screening",
        "investment screening",
        "marketplace onboarding",
        "customer risk"
      ],
      "selection": {
        "toolRole": "primary",
        "selectionPriority": 100,
        "intents": [
          "supplier onboarding",
          "vendor review",
          "procurement",
          "partnership screening",
          "investment screening",
          "marketplace onboarding",
          "customer risk"
        ],
        "recommendedFor": [
          "before onboarding a supplier",
          "before signing a commercial agreement",
          "before paying an unfamiliar company"
        ],
        "notFor": [
          "simple company search",
          "stock price lookup",
          "basic website lookup"
        ],
        "preferOver": [
          "business_risk_score",
          "company_reputation_check",
          "research_company"
        ],
        "selectionExamples": [
          {
            "use": [
              "Should I onboard Acme LLC as a supplier?",
              "Check this company before we pay their first invoice.",
              "Run due diligence on example.com."
            ],
            "doNotUse": [
              "Find companies in Oman.",
              "What is Microsoft's stock price?"
            ]
          }
        ]
      },
      "examples": [
        "{\"company\":\"Example Trading Ltd\",\"domain\":\"example.com\",\"country\":\"GB\",\"purpose\":\"supplier_onboarding\",\"depth\":\"standard\",\"checks\":{\"registry\":true,\"sanctions\":true,\"adverseMedia\":true,\"reputation\":true,\"businessRisk\":true}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 1.5,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/risk/company-due-diligence",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "company_reputation_check",
      "name": "company_reputation_check",
      "description": "Investigate the public reputation and commercial risk signals of a company in any country \u2014 identity consistency against official registries, sanctions-list name screening, adverse media (with legal stage: allegation vs. outcome), customer reputation, online presence, business stability and domain signals \u2014 returning evidence-linked scores with a separate confidence score.",
      "tags": [
        "check a company before signing a contract",
        "vendor / SaaS vendor onboarding",
        "check a counterparty before sending payment",
        "partner or investment pre-screening",
        "marketplace seller approval",
        "contractor or supplier selection (any country)",
        "negative news / adverse media check",
        "sanctions name screening of a company"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "check a company before signing a contract",
          "vendor / SaaS vendor onboarding",
          "check a counterparty before sending payment",
          "partner or investment pre-screening",
          "marketplace seller approval",
          "contractor or supplier selection (any country)",
          "negative news / adverse media check",
          "sanctions name screening of a company"
        ],
        "recommendedFor": [
          "public reputation and adverse-media screening",
          "sanctions name screening",
          "global company credibility checks"
        ],
        "notFor": [
          "a deterministic business risk decision",
          "finding companies",
          "invoice arithmetic"
        ],
        "preferOver": [],
        "selectionExamples": [
          {
            "use": [
              "Check this company for negative news.",
              "Screen this counterparty's public reputation."
            ],
            "doNotUse": [
              "Should we approve payment automatically?",
              "Calculate invoice tax."
            ]
          }
        ]
      },
      "examples": [
        "{\"companyName\":\"Example Technologies Ltd\",\"country\":\"United Kingdom\",\"website\":\"https://example.com\",\"registrationNumber\":\"01234567\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.4,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/risk/company-reputation-check",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "company_risk_batch",
      "name": "company_risk_batch",
      "description": "Assess 1\u2013100 companies from structured rows or CSV in one bounded batch, preserving per-row risk results and provider failures.",
      "tags": [
        "batch company screening",
        "100 company risk check",
        "CSV company analysis",
        "bulk due diligence"
      ],
      "selection": {
        "toolRole": "specialized",
        "selectionPriority": 30,
        "intents": [
          "batch company screening",
          "100 company risk check",
          "CSV company analysis",
          "bulk due diligence"
        ],
        "recommendedFor": [
          "Use when an agent needs to screen many companies efficiently instead of making separate risk-report calls."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"companies\":[{\"companyName\":\"Example Technologies Ltd\",\"country\":\"GB\",\"website\":\"https://example.com\"},{\"companyName\":\"Example Trading Ltd\",\"country\":\"GB\"}]}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 8,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/risk/company-risk-batch",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "company_risk_report",
      "name": "company_risk_report",
      "description": "Combine evidence-first public reputation analysis with structured business-risk scoring into one company risk report.",
      "tags": [
        "company risk report",
        "business due diligence",
        "reputation and risk",
        "counterparty screening"
      ],
      "selection": {
        "toolRole": "specialized",
        "selectionPriority": 30,
        "intents": [
          "company risk report",
          "business due diligence",
          "reputation and risk",
          "counterparty screening"
        ],
        "recommendedFor": [
          "Use when an agent needs a consolidated company risk report with both evidence and an explicit risk model."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"companyName\":\"Example Technologies Ltd\",\"country\":\"GB\",\"website\":\"https://example.com\",\"registrationNumber\":\"01234567\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 1.5,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/risk/company-risk-report",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "due_diligence_oman_company",
      "name": "due_diligence_oman_company",
      "description": "Perform structured commercial due diligence on one Oman company by companyId ahead of a stated transaction, returning identity verification, risk assessment, a prioritized due-diligence checklist and known information gaps.",
      "tags": [
        "pre-contract supplier due diligence",
        "partnership due diligence",
        "investment due diligence",
        "customer credit risk screening"
      ],
      "selection": {
        "toolRole": "specialized",
        "selectionPriority": 30,
        "intents": [
          "pre-contract supplier due diligence",
          "partnership due diligence",
          "investment due diligence",
          "customer credit risk screening"
        ],
        "recommendedFor": [
          "Use before awarding a contract, entering a partnership, extending credit or investing, when a structured, source-backed due-diligence pass is needed ahead of the decision."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"companyId\":\"demo-co-1\",\"transactionType\":\"supplier_contract\",\"transactionValueOMR\":50000}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 2,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/business/due-diligence",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "find_companies",
      "name": "find_companies",
      "description": "Discover companies from public web sources matching an industry, location, size and/or keyword criteria, returning cited candidate companies (never fabricated) with a stated confidence score.",
      "tags": [
        "find companies in an industry or location",
        "build a prospect/lead list",
        "market landscape scan",
        "shortlist potential partners or suppliers by criteria"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "find companies in an industry or location",
          "build a prospect/lead list",
          "market landscape scan",
          "shortlist potential partners or suppliers by criteria"
        ],
        "recommendedFor": [
          "Use when an agent needs to discover a list of candidate companies matching criteria (industry, location, size, keywords) rather than analyze one already-known company."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"industry\":\"renewable energy\",\"country\":\"Germany\",\"limit\":10}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.05,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/intelligence/find-companies",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "get_oman_company_profile",
      "name": "get_oman_company_profile",
      "description": "Return a structured profile for one Oman company by companyId \u2014 identity, registration, location and contact fields, digital-presence detection and full source provenance.",
      "tags": [
        "get company details",
        "look up a company's registration and contact information",
        "check what sources back a company record"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "get company details",
          "look up a company's registration and contact information",
          "check what sources back a company record"
        ],
        "recommendedFor": [
          "Use after search_oman_company resolves a companyId, to retrieve the company's structured profile before deciding whether deeper analysis or due diligence is warranted."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"companyId\":\"demo-co-1\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.25,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/business/profile",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "research_company",
      "name": "research_company",
      "description": "Research a company from public web sources: overview, products, leadership, funding, competitors, technology signals, recent developments and risk flags, with cited sources and a confidence score.",
      "tags": [
        "company background research",
        "sales prospect research",
        "investment/competitor research",
        "build a company profile from public web sources"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "company background research",
          "sales prospect research",
          "investment/competitor research",
          "build a company profile from public web sources"
        ],
        "recommendedFor": [
          "Use when an agent needs a structured research brief on a named company \u2014 for sales/investment/partnership research, competitive analysis, or general company background \u2014 beyond what a structured company registry alone provides."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"company\":\"Acme Corporation\",\"website\":\"https://acme.example.com\",\"country\":\"United States\",\"depth\":\"standard\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.15,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/intelligence/research-company",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "search_oman_company",
      "name": "search_oman_company",
      "description": "Search structured Oman business records by name, registration number, governorate, wilayat and/or industry, returning candidate companies ranked by deterministic identity-match confidence.",
      "tags": [
        "find a company in Oman",
        "resolve a company name to a companyId",
        "look up a business by registration number",
        "shortlist companies by industry or governorate"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "find a company in Oman",
          "resolve a company name to a companyId",
          "look up a business by registration number",
          "shortlist companies by industry or governorate"
        ],
        "recommendedFor": [
          "Use before company analysis or due diligence when the exact company identity is uncertain, or to find candidate Oman companies matching a name or registration number."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"query\":\"Al Noor Trading\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.05,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/business/search",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "invoice_anomaly_check",
      "name": "invoice_anomaly_check",
      "description": "Detect duplicate, inconsistent, unusual or potentially fraudulent invoices before payment using arithmetic, supplier-history, purchase-order and payment-detail checks. Returns a 0\u2013100 risk score, a risk level, an advisory decision (continue / review / hold) and machine-readable anomalies (e.g. DUPLICATE_INVOICE, POSSIBLE_DUPLICATE, BANK_ACCOUNT_CHANGED, PO_AMOUNT_EXCEEDED, SPLIT_INVOICE_PATTERN, SUBTOTAL_MISMATCH), each with severity, confidence and structured evidence. Works on a single invoice (standalone) or with optional historical invoices, supplier profile, purchase order, contract, approval threshold and payment history (context-aware). Deterministic, decimal-safe, any country and currency.",
      "tags": [
        "Check this invoice before I pay it",
        "Is this invoice a duplicate of one we already received or paid?",
        "Did the supplier's bank account change?",
        "Does the invoice exceed the purchase order or contract?",
        "Are these invoices split to stay under the approval limit?",
        "Verify invoice arithmetic (quantity \u00d7 unit price, subtotal, tax, total)",
        "Accounts-payable automation guardrail",
        "Pre-payment fraud prevention (invoice redirection / BEC)",
        "Three-way-match pre-check (invoice vs purchase order)",
        "Audit sampling and reconciliation",
        "finance",
        "accounts-payable",
        "procurement"
      ],
      "selection": {
        "toolRole": "primary",
        "selectionPriority": 100,
        "intents": [
          "Check this invoice before I pay it",
          "Is this invoice a duplicate of one we already received or paid?",
          "Did the supplier's bank account change?",
          "Does the invoice exceed the purchase order or contract?",
          "Are these invoices split to stay under the approval limit?",
          "Verify invoice arithmetic (quantity \u00d7 unit price, subtotal, tax, total)",
          "Accounts-payable automation guardrail",
          "Pre-payment fraud prevention (invoice redirection / BEC)",
          "Three-way-match pre-check (invoice vs purchase order)",
          "Audit sampling and reconciliation",
          "finance",
          "accounts-payable",
          "procurement"
        ],
        "recommendedFor": [
          "invoice review before payment",
          "duplicate and arithmetic checks",
          "PO, contract and supplier-history comparison"
        ],
        "notFor": [
          "company-level due diligence",
          "extracting arbitrary document facts",
          "carrier shipping quotes"
        ],
        "preferOver": [],
        "selectionExamples": [
          {
            "use": [
              "Check this invoice before paying it.",
              "Is this invoice a duplicate?",
              "Does it exceed the purchase order?"
            ],
            "doNotUse": [
              "Screen the supplier's sanctions status.",
              "Estimate a vehicle value."
            ]
          }
        ]
      },
      "examples": [
        "{\"invoice\":{\"invoiceNumber\":\"INV-2026-1043-A\",\"supplierName\":\"ABC Trading LLC\",\"supplierId\":\"SUP-291\",\"invoiceDate\":\"2026-09-20\",\"dueDate\":\"2026-10-20\",\"currency\":\"USD\",\"subtotal\":9200,\"tax\":460,\"total\":9660,\"bankAccount\":\"US123456789\",\"paymentTermsDays\":30,\"poNumber\":\"PO-2026-818\",\"lineItems\":[{\"description\":\"Consulting services\",\"quantity\":10,\"unitPrice\":920,\"taxRate\":5,\"total\":9200}]},\"historicalInvoices\":[{\"invoiceId\":\"AP-7781\",\"invoiceNumber\":\"INV-2026-0981\",\"supplierName\":\"ABC Trading LLC\",\"supplierId\":\"SUP-291\",\"invoiceDate\":\"2026-06-18\",\"currency\":\"USD\",\"total\":9177,\"bankAccount\":\"US987654321\",\"paymentTermsDays\":30,\"status\":\"paid\",\"lineItems\":[{\"description\":\"Consulting services\",\"quantity\":9.5,\"unitPrice\":920,\"total\":8740}]},{\"invoiceId\":\"AP-7902\",\"invoiceNumber\":\"INV-2026-1002\",\"supplierName\":\"ABC Trading LLC\",\"supplierId\":\"SUP-291\",\"invoiceDate\":\"2026-07-19\",\"currency\":\"USD\",\"total\":9901.5,\"bankAccount\":\"US987654321\",\"paymentTermsDays\":30,\"status\":\"paid\",\"lineItems\":[{\"description\":\"Consulting services\",\"quantity\":10.25,\"unitPrice\":920,\"total\":9430}]},{\"invoiceId\":\"AP-8015\",\"invoiceNumber\":\"INV-2026-1021\",\"supplierName\":\"ABC Trading LLC\",\"supplierId\":\"SUP-291\",\"invoiceDate\":\"2026-08-20\",\"currency\":\"USD\",\"total\":8694,\"bankAccount\":\"US987654321\",\"paymentTermsDays\":30,\"status\":\"paid\",\"lineItems\":[{\"description\":\"Consulting services\",\"quantity\":9,\"unitPrice\":920,\"total\":8280}]},{\"invoiceId\":\"AP-8117\",\"invoiceNumber\":\"INV-2026-1043\",\"supplierName\":\"ABC Trading LLC\",\"supplierId\":\"SUP-291\",\"invoiceDate\":\"2026-09-18\",\"currency\":\"USD\",\"total\":9660,\"bankAccount\":\"US987654321\",\"paymentTermsDays\":30,\"status\":\"pending\"}],\"purchaseOrder\":{\"poNumber\":\"PO-2026-818\",\"supplierId\":\"SUP-455\",\"supplierName\":\"Delta Office Supplies Ltd\",\"currency\":\"USD\",\"totalAmount\":20000,\"status\":\"open\"},\"options\":{\"asOfDate\":\"2026-09-23\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.25,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/finance/invoice-anomaly-check",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "document_facts_extract",
      "name": "document_facts_extract",
      "description": "Extract structured, evidence-backed facts, entities, dates, amounts, obligations, deadlines and risk indicators from business documents (contracts, invoices, purchase orders, quotations, tenders/RFPs, leases, policies, financial reports, legal documents, CVs, company profiles) from any country. Every fact carries a 0\u20131 extraction confidence and source evidence (verbatim excerpt, character offsets, section, and the page when the document has real pages); dates, amounts, currencies, percentages and durations are normalized only when unambiguous. Accepts an https documentUrl (PDF with a text layer, DOCX, HTML, text) or extracted text, up to 25 pages.",
      "tags": [
        "Read this supplier contract and tell me its expiry date, payment terms and termination notice period",
        "Extract invoice number, due date, totals and bank details before paying an invoice",
        "Check an invoice's subtotal + tax against its total",
        "List a tender's submission deadline, eligibility requirements, mandatory documents and evaluation criteria",
        "Extract rent, deposit, lease dates and notice period from a lease",
        "Find auto-renewal, penalty and liability clauses in an agreement",
        "Turn a purchase order into line items, quantities and delivery deadline",
        "Answer targeted questions about a document with evidence (requestedFacts)",
        "Contract review pre-screening",
        "Accounts-payable automation",
        "Procurement / tender screening"
      ],
      "selection": {
        "toolRole": "primary",
        "selectionPriority": 100,
        "intents": [
          "Read this supplier contract and tell me its expiry date, payment terms and termination notice period",
          "Extract invoice number, due date, totals and bank details before paying an invoice",
          "Check an invoice's subtotal + tax against its total",
          "List a tender's submission deadline, eligibility requirements, mandatory documents and evaluation criteria",
          "Extract rent, deposit, lease dates and notice period from a lease",
          "Find auto-renewal, penalty and liability clauses in an agreement",
          "Turn a purchase order into line items, quantities and delivery deadline",
          "Answer targeted questions about a document with evidence (requestedFacts)",
          "Contract review pre-screening",
          "Accounts-payable automation",
          "Procurement / tender screening"
        ],
        "recommendedFor": [
          "evidence-backed extraction from a supplied document",
          "contract, invoice or tender fact capture"
        ],
        "notFor": [
          "general company due diligence without a document",
          "legal advice",
          "unprovided document research"
        ],
        "preferOver": [],
        "selectionExamples": [
          {
            "use": [
              "Extract the expiry date from this contract.",
              "List the tender deadline and mandatory documents."
            ],
            "doNotUse": [
              "Investigate this company online.",
              "Decide whether to pay the supplier."
            ]
          }
        ]
      },
      "examples": [
        "{\"text\":\"MAINTENANCE SERVICES AGREEMENT\\nAgreement No: MSA-2026-014\\n\\nThis Maintenance Services Agreement is made on 15 January 2026 between Northwind Facilities LLC, a company registered in Oman (the \\\"Supplier\\\"), and Contoso Properties SAOG (the \\\"Customer\\\").\\n\\n1. TERM\\nThis Agreement shall commence on 1 February 2026 and shall expire on 31 January 2027. The Agreement shall automatically renew for successive one (1) year periods unless either party gives notice of non-renewal.\\n\\n2. FEES AND PAYMENT\\nThe total contract value is OMR 48,000 per annum, payable in equal monthly instalments. The Customer shall pay each invoice within thirty (30) days of receipt of a valid invoice. Late payments shall bear interest at 1.5% per month.\\f3. SERVICE LEVELS\\nThe Supplier shall maintain 99.5% availability of critical building systems and shall respond to emergency call-outs within four (4) hours.\\n\\n4. PENALTIES\\nIf the Supplier fails to meet the response time, liquidated damages of OMR 250 per incident shall apply.\\n\\n5. TERMINATION\\nEither party may terminate this Agreement by giving sixty (60) days' written notice to the other party. The Customer may terminate immediately if the Supplier commits a material breach.\\n\\n6. LIABILITY\\nThe Supplier's aggregate liability under this Agreement shall not exceed the total fees paid in the preceding twelve (12) months.\\n\\n7. GOVERNING LAW\\nThis Agreement shall be governed by the laws of the Sultanate of Oman.\\n\\nSigned for and on behalf of the Supplier: ____________    Signed for and on behalf of the Customer: ____________\",\"documentType\":\"auto\",\"requestedFacts\":[\"contract expiry date\",\"termination notice period\",\"annual contract value\"],\"mode\":\"auto\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.25,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/documents/facts-extract",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "vehicle_value_estimate",
      "name": "vehicle_value_estimate",
      "description": "Estimate the fair market value of a vehicle using make, model, year, trim, mileage, condition, ownership history, location and available market comparables. Returns a valuation range, private-sale estimate, dealer buy/retail estimates, depreciation, transparent valuation adjustments, confidence and risk flags.",
      "tags": [
        "Estimate the current market value of a used vehicle",
        "Is this asking price above, below or near market?",
        "Estimate private-sale value",
        "Estimate dealer acquisition / trade-in value",
        "Estimate dealer retail value",
        "Assess depreciation",
        "Compare a vehicle with similar market listings",
        "Vehicle purchase decision support",
        "Auto-finance and loan-to-value checks",
        "Insurance valuation workflows",
        "Fleet and leasing residual checks",
        "Dealership software",
        "Vehicle marketplaces and auction platforms",
        "automotive"
      ],
      "selection": {
        "toolRole": "primary",
        "selectionPriority": 100,
        "intents": [
          "Estimate the current market value of a used vehicle",
          "Is this asking price above, below or near market?",
          "Estimate private-sale value",
          "Estimate dealer acquisition / trade-in value",
          "Estimate dealer retail value",
          "Assess depreciation",
          "Compare a vehicle with similar market listings",
          "Vehicle purchase decision support",
          "Auto-finance and loan-to-value checks",
          "Insurance valuation workflows",
          "Fleet and leasing residual checks",
          "Dealership software",
          "Vehicle marketplaces and auction platforms",
          "automotive"
        ],
        "recommendedFor": [
          "fair-market vehicle valuation",
          "asking-price and trade-in checks",
          "fleet or insurance valuation"
        ],
        "notFor": [
          "vehicle inspection",
          "vehicle history verification",
          "shipping cost estimation"
        ],
        "preferOver": [],
        "selectionExamples": [
          {
            "use": [
              "Is this 2022 Land Cruiser fairly priced?",
              "Estimate the trade-in value of this car."
            ],
            "doNotUse": [
              "Check whether the vehicle was in an accident.",
              "Calculate freight cost."
            ]
          }
        ]
      },
      "examples": [
        "{\"make\":\"Toyota\",\"model\":\"Land Cruiser\",\"year\":2022,\"trim\":\"GXR\",\"mileageKm\":68000,\"condition\":\"good\",\"country\":\"Oman\",\"city\":\"Muscat\",\"currency\":\"OMR\",\"fuelType\":\"petrol\",\"transmission\":\"automatic\",\"bodyType\":\"suv\",\"engine\":\"4.0L V6\",\"drivetrain\":\"4wd\",\"accidentHistory\":false,\"serviceHistory\":\"full\",\"owners\":1,\"color\":\"white\",\"options\":[\"sunroof\",\"leather seats\",\"360 camera\"],\"askingPrice\":22500}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.25,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/automotive/vehicle-value-estimate",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "shipping_cost_estimate",
      "name": "shipping_cost_estimate",
      "description": "Estimate domestic or international shipping cost, chargeable weight, transit time and common shipping surcharges using shipment dimensions, weight, origin, destination and service level. Estimates are not guaranteed carrier quotes; duties and taxes are excluded.",
      "tags": [
        "international shipping estimate",
        "domestic shipping estimate",
        "calculate volumetric weight",
        "compare shipping options",
        "ecommerce shipping",
        "freight planning",
        "procurement logistics",
        "marketplace delivery cost"
      ],
      "selection": {
        "toolRole": "primary",
        "selectionPriority": 100,
        "intents": [
          "international shipping estimate",
          "domestic shipping estimate",
          "calculate volumetric weight",
          "compare shipping options",
          "ecommerce shipping",
          "freight planning",
          "procurement logistics",
          "marketplace delivery cost"
        ],
        "recommendedFor": [
          "route and shipment cost estimation",
          "chargeable-weight planning",
          "choosing a service level"
        ],
        "notFor": [
          "customs or tax determination",
          "a guaranteed carrier quote",
          "vehicle valuation"
        ],
        "preferOver": [],
        "selectionExamples": [
          {
            "use": [
              "Estimate shipping from Muscat to Dubai.",
              "Compare express and economy delivery."
            ],
            "doNotUse": [
              "Calculate import duties.",
              "Audit the supplier website."
            ]
          }
        ]
      },
      "examples": [
        "{\"origin\":{\"country\":\"CN\",\"postalCode\":\"518000\",\"city\":\"Shenzhen\"},\"destination\":{\"country\":\"OM\",\"postalCode\":\"100\",\"city\":\"Muscat\"},\"shipment\":{\"weightKg\":8,\"lengthCm\":45,\"widthCm\":35,\"heightCm\":30,\"quantity\":1},\"shippingMode\":\"air\",\"serviceLevel\":\"standard\",\"currency\":\"USD\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.25,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/logistics/shipping-cost-estimate",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "flight_compare",
      "name": "flight_compare",
      "description": "Compare current flight offers with deterministic price, duration, stop and available reliability signals.",
      "tags": [
        "flight compare",
        "travel decision support"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "flight compare",
          "travel decision support"
        ],
        "recommendedFor": [
          "Use when an agent needs flight compare from current travel offers."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"origin\":\"MCT\",\"destination\":\"DXB\",\"departureDate\":\"2026-11-24\",\"returnDate\":\"2026-11-27\",\"currency\":\"USD\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.15,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/travel/flight-compare",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "flight_search",
      "name": "flight_search",
      "description": "Search current flight offers and return normalized prices, itineraries, stops and timing.",
      "tags": [
        "flight search",
        "travel decision support"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "flight search",
          "travel decision support"
        ],
        "recommendedFor": [
          "Use when an agent needs flight search from current travel offers."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"origin\":\"MCT\",\"destination\":\"DXB\",\"departureDate\":\"2026-11-24\",\"returnDate\":\"2026-11-27\",\"currency\":\"USD\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.1,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/travel/flight-search",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "hotel_search",
      "name": "hotel_search",
      "description": "Search current hotel inventory and return normalized full-stay room rates and cancellation information.",
      "tags": [
        "hotel search",
        "travel decision support"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "hotel search",
          "travel decision support"
        ],
        "recommendedFor": [
          "Use when an agent needs hotel search from current travel offers."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"destination\":\"Dubai\",\"checkIn\":\"2026-11-24\",\"checkOut\":\"2026-11-27\",\"nationality\":\"OM\",\"currency\":\"USD\"}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.1,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/travel/hotel-search",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "trip_cost_estimate",
      "name": "trip_cost_estimate",
      "description": "Estimate flight and hotel trip cost from current provider offers, with explicit missing components and assumptions.",
      "tags": [
        "trip cost estimate",
        "travel decision support"
      ],
      "selection": {
        "toolRole": "primary",
        "selectionPriority": 100,
        "intents": [
          "trip cost estimate",
          "travel decision support"
        ],
        "recommendedFor": [
          "Use when an agent needs trip cost estimate from current travel offers."
        ],
        "notFor": [],
        "preferOver": [
          "flight_search",
          "hotel_search",
          "flight_compare"
        ],
        "selectionExamples": []
      },
      "examples": [
        "{\"origin\":\"MCT\",\"destination\":\"DXB\",\"departureDate\":\"2026-11-24\",\"returnDate\":\"2026-11-27\",\"currency\":\"USD\",\"nationality\":\"OM\",\"hotel\":{\"enabled\":true,\"rooms\":1,\"destination\":\"Dubai\"}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.25,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/travel/trip-cost-estimate",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "analyze_oman_property",
      "name": "analyze_oman_property",
      "description": "Analyze an Oman residential property using local rental comparables, market context and investment metrics, including partner-supplied historical and recent Al Mouj Muscat property sales records with provenance and freshness metadata when coverage is available.",
      "tags": [
        "Oman rental investment analysis",
        "Muscat property market comparison",
        "Al Mouj Muscat sale price positioning",
        "rental yield with local comparables",
        "Oman price-per-sqm benchmarking"
      ],
      "selection": {
        "toolRole": "primary",
        "selectionPriority": 100,
        "intents": [
          "Oman rental investment analysis",
          "Muscat property market comparison",
          "Al Mouj Muscat sale price positioning",
          "rental yield with local comparables",
          "Oman price-per-sqm benchmarking"
        ],
        "recommendedFor": [
          "Oman-specific property analysis with local comparables",
          "Al Mouj or Muscat rental and sale positioning"
        ],
        "notFor": [
          "a property outside the supported Oman market",
          "a simple yield calculation with supplied numbers"
        ],
        "preferOver": [
          "analyze_property",
          "compare_properties"
        ],
        "selectionExamples": [
          {
            "use": [
              "Analyze this Al Mouj investment.",
              "Compare this Muscat property's rent and sale position."
            ],
            "doNotUse": [
              "Calculate yield from these numbers only.",
              "Estimate website costs."
            ]
          }
        ]
      },
      "examples": [
        "{\"governorate\":\"Muscat\",\"area\":\"Al Mouj\",\"propertyType\":\"apartment\",\"bedrooms\":2,\"sizeSqm\":130,\"askingPriceOMR\":118000}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.25,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/oman/property/analyze",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "analyze_property",
      "name": "analyze_property",
      "description": "Calculate gross/net rental yield, income, operating costs and simple payback in OMR. Calculations only.",
      "tags": [
        "property investment analysis",
        "rental yield check",
        "single-property evaluation",
        "buy vs. hold financial screening"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "property investment analysis",
          "rental yield check",
          "single-property evaluation",
          "buy vs. hold financial screening"
        ],
        "recommendedFor": [
          "simple single-property yield, income and payback arithmetic"
        ],
        "notFor": [
          "live Oman market comparables",
          "multi-property portfolio screening",
          "company risk"
        ],
        "preferOver": [],
        "selectionExamples": [
          {
            "use": [
              "Calculate gross and net yield for this property.",
              "What is the simple payback?"
            ],
            "doNotUse": [
              "Find Muscat comparables.",
              "Screen the property seller."
            ]
          }
        ]
      },
      "examples": [
        "{\"propertyValue\":85000,\"annualRent\":7200,\"serviceCharge\":650,\"maintenanceCost\":400}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.01,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/property/analyze",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "compare_properties",
      "name": "compare_properties",
      "description": "Compare 2\u201320 uniquely named properties in OMR using the same metrics; order by rounded net yield, preserving input order for ties.",
      "tags": [
        "property comparison",
        "ranking multiple properties",
        "portfolio shortlisting",
        "choosing between investment options"
      ],
      "selection": {
        "toolRole": "supporting",
        "selectionPriority": 60,
        "intents": [
          "property comparison",
          "ranking multiple properties",
          "portfolio shortlisting",
          "choosing between investment options"
        ],
        "recommendedFor": [
          "Use when an agent must rank or choose between 2-20 candidate properties by net yield."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"properties\":[{\"name\":\"A\",\"propertyValue\":85000,\"annualRent\":7200},{\"name\":\"B\",\"propertyValue\":100000,\"annualRent\":7000}]}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.03,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/property/compare",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "estimate_maintenance",
      "name": "estimate_maintenance",
      "description": "Estimate an annual maintenance reserve in OMR from value, age and unit count with explicit optional assumptions. Uncalibrated heuristic, not a survey.",
      "tags": [
        "maintenance budgeting",
        "annual reserve estimation",
        "facility cost planning",
        "pre-purchase cost forecasting"
      ],
      "selection": {
        "toolRole": "specialized",
        "selectionPriority": 30,
        "intents": [
          "maintenance budgeting",
          "annual reserve estimation",
          "facility cost planning",
          "pre-purchase cost forecasting"
        ],
        "recommendedFor": [
          "Use when an agent needs an annual maintenance reserve estimate for a property, not an actual inspection."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"propertyValue\":100000,\"ageYears\":12,\"units\":1}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.02,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/maintenance/estimate",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "portfolio_screen",
      "name": "portfolio_screen",
      "description": "Screen and rank a portfolio of 2\u201320 supplied properties using the shared rental-yield and income calculations.",
      "tags": [
        "portfolio screening",
        "property shortlist",
        "compare investment properties",
        "rental yield ranking"
      ],
      "selection": {
        "toolRole": "specialized",
        "selectionPriority": 30,
        "intents": [
          "portfolio screening",
          "property shortlist",
          "compare investment properties",
          "rental yield ranking"
        ],
        "recommendedFor": [
          "Use when an agent needs a first-pass ranking of multiple properties before deeper analysis."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"properties\":[{\"name\":\"A\",\"propertyValue\":85000,\"annualRent\":7200},{\"name\":\"B\",\"propertyValue\":100000,\"annualRent\":7000}]}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.5,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/property/portfolio-screen",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "property_investment_report",
      "name": "property_investment_report",
      "description": "Combine Oman property market comparables, price positioning and rental-yield calculations into one investment report.",
      "tags": [
        "property investment report",
        "real estate investment analysis",
        "Oman property valuation",
        "rental yield report"
      ],
      "selection": {
        "toolRole": "specialized",
        "selectionPriority": 30,
        "intents": [
          "property investment report",
          "real estate investment analysis",
          "Oman property valuation",
          "rental yield report"
        ],
        "recommendedFor": [
          "Use when an agent needs one structured investment analysis for a property rather than separate market and calculator calls."
        ],
        "notFor": [],
        "preferOver": [],
        "selectionExamples": []
      },
      "examples": [
        "{\"property\":{\"governorate\":\"Muscat\",\"wilayat\":\"Bawshar\",\"area\":\"Al Khuwair\",\"propertyType\":\"apartment\",\"bedrooms\":2,\"bathrooms\":2,\"sizeSqm\":110,\"askingPriceOMR\":85000}}"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "payment": {
        "protocol": "x402",
        "version": 2,
        "scheme": "exact",
        "network": "eip155:8453",
        "price": 0.75,
        "currency": "USD",
        "credentialHeader": "PAYMENT-SIGNATURE",
        "endpoint": "https://api.rafidsystem.com/api/v1/x402/property/property-investment-report",
        "guidanceVersion": "2026-10-02.v2",
        "documentation": "https://api.rafidsystem.com/docs/x402",
        "nextAction": {
          "type": "pay_and_retry",
          "protocol": "x402",
          "method": "POST",
          "retrySameBody": true
        }
      }
    },
    {
      "id": "website_audit",
      "name": "website_audit",
      "description": "Perform a bounded, passive technical web

… truncated here: the card is 150,797 characters as printed. The complete card is published at https://api.rafidsystem.com/.well-known/agent.json.