{"success":true,"data":[{"name":"analyze_property","description":"Calculate gross/net rental yield, income, operating costs and simple payback in OMR. Calculations only.","whenToUse":"Use when an agent needs financial metrics (yield, income, payback) for a single property.","useCases":["property investment analysis","rental yield check","single-property evaluation","buy vs. hold financial screening"],"price":0.01,"currency":"USD","paymentProtocol":"x402","network":"eip155:8453","idempotent":true,"sideEffects":false,"endpoint":"/api/v1/property/analyze","x402Endpoint":"/api/v1/x402/property/analyze","method":"POST","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"propertyValue":{"type":"number","minimum":0.01,"maximum":1000000000000},"annualRent":{"type":"number","minimum":0,"maximum":1000000000000},"serviceCharge":{"type":"number","minimum":0,"maximum":1000000000000},"maintenanceCost":{"type":"number","minimum":0,"maximum":1000000000000},"maintenance":{"description":"Legacy alias for maintenanceCost; supply only one","type":"number","minimum":0,"maximum":1000000000000},"vacancyRatePct":{"type":"number","minimum":0,"maximum":100},"otherAnnualCosts":{"type":"number","minimum":0,"maximum":1000000000000}},"required":["propertyValue","annualRent"],"additionalProperties":false,"examples":[{"propertyValue":85000,"annualRent":7200,"serviceCharge":650,"maintenanceCost":400}]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"propertyValue":{"type":"number"},"annualRent":{"type":"number"},"grossAnnualIncome":{"type":"number"},"grossYield":{"type":"number"},"netYield":{"type":"number"},"annualOperatingCost":{"type":"number"},"annualNetIncome":{"type":"number"},"effectiveAnnualRent":{"type":"number"},"paybackYears":{"type":["number","null"]},"grossYieldPct":{"type":"number"},"netYieldPct":{"type":"number"},"annualOperatingCosts":{"type":"number"},"currency":{"type":"string","const":"OMR"},"note":{"type":"string"}},"required":["propertyValue","annualRent","grossAnnualIncome","grossYield","netYield","annualOperatingCost","annualNetIncome","effectiveAnnualRent","paybackYears","grossYieldPct","netYieldPct","annualOperatingCosts","currency","note"],"additionalProperties":false},"priorityContexts":[],"evidenceTypes":[],"limitations":[],"sampleQueries":[]},{"name":"compare_properties","description":"Compare 2–20 uniquely named properties in OMR using the same metrics; order by rounded net yield, preserving input order for ties.","whenToUse":"Use when an agent must rank or choose between 2-20 candidate properties by net yield.","useCases":["property comparison","ranking multiple properties","portfolio shortlisting","choosing between investment options"],"price":0.03,"currency":"USD","paymentProtocol":"x402","network":"eip155:8453","idempotent":true,"sideEffects":false,"endpoint":"/api/v1/property/compare","x402Endpoint":"/api/v1/x402/property/compare","method":"POST","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"properties":{"minItems":2,"maxItems":20,"type":"array","items":{"type":"object","properties":{"propertyValue":{"type":"number","minimum":0.01,"maximum":1000000000000},"annualRent":{"type":"number","minimum":0,"maximum":1000000000000},"serviceCharge":{"type":"number","minimum":0,"maximum":1000000000000},"maintenanceCost":{"type":"number","minimum":0,"maximum":1000000000000},"maintenance":{"description":"Legacy alias for maintenanceCost; supply only one","type":"number","minimum":0,"maximum":1000000000000},"vacancyRatePct":{"type":"number","minimum":0,"maximum":100},"otherAnnualCosts":{"type":"number","minimum":0,"maximum":1000000000000},"name":{"type":"string","minLength":1,"maxLength":120}},"required":["propertyValue","annualRent","name"],"additionalProperties":false}}},"required":["properties"],"additionalProperties":false,"examples":[{"properties":[{"name":"A","propertyValue":85000,"annualRent":7200},{"name":"B","propertyValue":100000,"annualRent":7000}]}]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"properties":{"type":"array","items":{"type":"object","properties":{"propertyValue":{"type":"number"},"annualRent":{"type":"number"},"grossAnnualIncome":{"type":"number"},"grossYield":{"type":"number"},"netYield":{"type":"number"},"annualOperatingCost":{"type":"number"},"annualNetIncome":{"type":"number"},"effectiveAnnualRent":{"type":"number"},"paybackYears":{"type":["number","null"]},"grossYieldPct":{"type":"number"},"netYieldPct":{"type":"number"},"annualOperatingCosts":{"type":"number"},"currency":{"type":"string","const":"OMR"},"note":{"type":"string"},"name":{"type":"string"}},"required":["propertyValue","annualRent","grossAnnualIncome","grossYield","netYield","annualOperatingCost","annualNetIncome","effectiveAnnualRent","paybackYears","grossYieldPct","netYieldPct","annualOperatingCosts","currency","note","name"],"additionalProperties":false}},"sortedByNetYield":{"type":"array","items":{"type":"string"}}},"required":["properties","sortedByNetYield"],"additionalProperties":false},"priorityContexts":[],"evidenceTypes":[],"limitations":[],"sampleQueries":[]},{"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.","whenToUse":"Use when an agent needs an annual maintenance reserve estimate for a property, not an actual inspection.","useCases":["maintenance budgeting","annual reserve estimation","facility cost planning","pre-purchase cost forecasting"],"price":0.02,"currency":"USD","paymentProtocol":"x402","network":"eip155:8453","idempotent":true,"sideEffects":false,"endpoint":"/api/v1/maintenance/estimate","x402Endpoint":"/api/v1/x402/maintenance/estimate","method":"POST","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"propertyValue":{"type":"number","minimum":0.01,"maximum":1000000000000},"ageYears":{"type":"number","minimum":0,"maximum":200},"units":{"type":"integer","minimum":1,"maximum":10000},"annualRent":{"description":"Legacy input; unused in this value-based estimate","type":"number","minimum":0,"maximum":1000000000000},"assumptions":{"type":"object","properties":{"annualRatePct":{"type":"number","minimum":0,"maximum":100},"additionalUnitCost":{"type":"number","minimum":0,"maximum":1000000000000}},"additionalProperties":false}},"required":["propertyValue"],"additionalProperties":false,"examples":[{"propertyValue":100000,"ageYears":12,"units":1}]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"estimatedAnnualMaintenance":{"type":"number"},"monthlyReserve":{"type":"number"},"maintenancePercentage":{"type":"number"},"currency":{"type":"string","const":"OMR"},"assumptionsUsed":{"type":"object","properties":{"ageYears":{"type":"number"},"units":{"type":"number"},"annualRatePct":{"type":"number"},"additionalUnitCost":{"type":"number"}},"required":["ageYears","units","annualRatePct","additionalUnitCost"],"additionalProperties":false},"methodology":{"type":"string"}},"required":["estimatedAnnualMaintenance","monthlyReserve","maintenancePercentage","currency","assumptionsUsed","methodology"],"additionalProperties":false},"priorityContexts":[],"evidenceTypes":[],"limitations":[],"sampleQueries":[]},{"name":"analyze_oman_property","description":"Analyze an Oman residential property using local rental comparables, market context and investment metrics.","whenToUse":"Use when an agent needs Oman-specific rental, yield, price-position or operating-cost analysis.","useCases":["Oman rental investment analysis","Muscat property market comparison","rental yield with local comparables","Oman price-per-sqm benchmarking"],"price":0.25,"currency":"USD","paymentProtocol":"x402","network":"eip155:8453","idempotent":true,"sideEffects":false,"endpoint":"/api/v1/oman/property/analyze","x402Endpoint":"/api/v1/x402/oman/property/analyze","method":"POST","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"governorate":{"type":"string","minLength":1,"maxLength":60},"wilayat":{"type":"string","minLength":1,"maxLength":60},"area":{"type":"string","minLength":1,"maxLength":80},"propertyType":{"type":"string","enum":["apartment","villa","townhouse"]},"bedrooms":{"type":"integer","minimum":0,"maximum":20},"bathrooms":{"type":"integer","minimum":0,"maximum":20},"sizeSqm":{"type":"number","minimum":10,"maximum":5000},"askingPriceOMR":{"type":"number","minimum":1000,"maximum":1000000000},"furnished":{"type":"string","enum":["furnished","semi_furnished","unfurnished"]},"optionalAnnualServiceChargeOMR":{"type":"number","minimum":0,"maximum":1000000000},"optionalAnnualMaintenanceOMR":{"type":"number","minimum":0,"maximum":1000000000}},"required":["governorate","area","propertyType","sizeSqm","askingPriceOMR"],"additionalProperties":false,"examples":[{"governorate":"Muscat","area":"Al Mouj","propertyType":"apartment","bedrooms":2,"sizeSqm":130,"askingPriceOMR":118000}]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"normalizedLocation":{"type":"object","properties":{"governorate":{"type":"string"},"wilayat":{"type":"string"},"area":{"type":"string"},"inputArea":{"type":"string"},"matchType":{"type":"string","enum":["exact","alias","unmatched"]},"supported":{"type":"boolean"}},"required":["governorate","wilayat","area","inputArea","matchType","supported"],"additionalProperties":false},"subjectProperty":{"type":"object","properties":{"propertyType":{"type":"string","enum":["apartment","villa","townhouse"]},"bedrooms":{"type":["number","null"]},"bathrooms":{"type":["number","null"]},"sizeSqm":{"type":"number"},"askingPriceOMR":{"type":"number"},"furnished":{"type":"string","enum":["furnished","semi_furnished","unfurnished","unspecified"]}},"required":["propertyType","bedrooms","bathrooms","sizeSqm","askingPriceOMR","furnished"],"additionalProperties":false},"market":{"type":"object","properties":{"estimatedMonthlyRentOMR":{"anyOf":[{"type":"object","properties":{"low":{"type":"number"},"median":{"type":"number"},"high":{"type":"number"}},"required":["low","median","high"],"additionalProperties":false},{"type":"null"}]},"estimatedAnnualRentOMR":{"type":["number","null"]},"comparableCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sampleSizeUsed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dataFreshnessDays":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["estimatedMonthlyRentOMR","estimatedAnnualRentOMR","comparableCount","sampleSizeUsed","dataFreshnessDays"],"additionalProperties":false},"investment":{"type":"object","properties":{"grossYieldPct":{"type":["number","null"]},"estimatedOperatingCostOMR":{"type":"number"},"estimatedNetIncomeOMR":{"type":["number","null"]},"netYieldPct":{"type":["number","null"]}},"required":["grossYieldPct","estimatedOperatingCostOMR","estimatedNetIncomeOMR","netYieldPct"],"additionalProperties":false},"pricePosition":{"type":"object","properties":{"askingPricePerSqmOMR":{"type":"number"},"observedComparableRange":{"anyOf":[{"type":"object","properties":{"low":{"type":"number"},"median":{"type":"number"},"high":{"type":"number"}},"required":["low","median","high"],"additionalProperties":false},{"type":"null"}]},"marketPosition":{"type":"string","enum":["below_market","at_market","above_market","insufficient_data"]}},"required":["askingPricePerSqmOMR","observedComparableRange","marketPosition"],"additionalProperties":false},"comparablesSummary":{"anyOf":[{"type":"object","properties":{"medianRentPerSqm":{"type":"number"},"lowRentPerSqm":{"type":"number"},"highRentPerSqm":{"type":"number"}},"required":["medianRentPerSqm","lowRentPerSqm","highRentPerSqm"],"additionalProperties":false},{"type":"null"}]},"riskFlags":{"type":"array","items":{"type":"string"}},"confidence":{"type":"object","properties":{"score":{"type":"number","minimum":0,"maximum":1},"level":{"type":"string","enum":["insufficient","low","medium","high"]},"reasons":{"type":"array","items":{"type":"string"}}},"required":["score","level","reasons"],"additionalProperties":false},"provenance":{"type":"array","items":{"type":"object","properties":{"sourceType":{"type":"string","enum":["official_statistics","listing_asking_price","manual_benchmark","partner_feed"]},"sourceName":{"type":"string"},"sourceDate":{"type":"string"},"recordCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["sourceType","sourceName","sourceDate","recordCount"],"additionalProperties":false}},"assumptions":{"type":"array","items":{"type":"string"}},"insufficientMarketData":{"type":"boolean"},"unavailableOutputs":{"type":"array","items":{"type":"string"}},"currency":{"type":"string","const":"OMR"},"dataQuality":{"type":"object","properties":{"latestDataDate":{"type":["string","null"]},"dataFreshnessDays":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"sampleSize":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sourceTypes":{"type":"array","items":{"type":"string","enum":["official_statistics","listing_asking_price","manual_benchmark","partner_feed"]}},"staleMarketData":{"type":"boolean"}},"required":["latestDataDate","dataFreshnessDays","sampleSize","sourceTypes","staleMarketData"],"additionalProperties":false},"historicalSalesContext":{"type":"object","properties":{"available":{"type":"boolean"},"recordsAvailable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"recentComparableSales":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"medianHistoricalPricePerSqmOMR":{"type":["number","null"]},"recentMedianPricePerSqmOMR":{"type":["number","null"]},"oldestRecordDate":{"type":["string","null"]},"latestRecordDate":{"type":["string","null"]},"sourceTypes":{"type":"array","items":{"type":"string"}},"priceSemantics":{"type":"array","items":{"type":"string"}},"phaseBreakdown":{"type":"array","items":{"type":"object","properties":{"phaseName":{"type":"string"},"recordCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"medianPriceOMR":{"type":"number"},"medianPricePerSqmOMR":{"type":"number"},"oldestRecordDate":{"type":"string"},"latestRecordDate":{"type":"string"}},"required":["phaseName","recordCount","medianPriceOMR","medianPricePerSqmOMR","oldestRecordDate","latestRecordDate"],"additionalProperties":false}}},"required":["available","recordsAvailable","recentComparableSales","medianHistoricalPricePerSqmOMR","recentMedianPricePerSqmOMR","oldestRecordDate","latestRecordDate","sourceTypes","priceSemantics","phaseBreakdown"],"additionalProperties":false},"officialMarketContext":{"type":"object","properties":{"available":{"type":"boolean"},"reason":{"anyOf":[{"type":"string","enum":["ncsi_not_configured","no_data_for_governorate","ncsi_timeout","ncsi_malformed_response","official_source_temporarily_unavailable"]},{"type":"null"}]},"source":{"type":"string"},"sourceType":{"type":"string","const":"official_statistics"},"governorate":{"type":"string"},"period":{"type":["string","null"]},"realEstatePriceIndex":{"type":"object","properties":{"value":{"type":["number","null"]},"period":{"type":["string","null"]}},"required":["value","period"],"additionalProperties":false},"marketActivity":{"type":"object","properties":{"tradedValueOMR":{"type":["number","null"]},"saleContracts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"mortgageContracts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["tradedValueOMR","saleContracts","mortgageContracts"],"additionalProperties":false},"dataFreshnessDays":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"confidence":{"type":"object","properties":{"level":{"type":"string","enum":["unavailable","low","medium","high"]},"reasons":{"type":"array","items":{"type":"string"}}},"required":["level","reasons"],"additionalProperties":false},"provenance":{"type":"object","properties":{"source":{"type":"string"},"sourceType":{"type":"string","const":"official_statistics"},"datasetId":{"type":["string","null"]},"datasetTitle":{"type":["string","null"]},"retrievedAt":{"type":["string","null"]},"publishedAt":{"type":["string","null"]},"sourceUrl":{"type":["string","null"]},"license":{"type":"string"}},"required":["source","sourceType","datasetId","datasetTitle","retrievedAt","publishedAt","sourceUrl","license"],"additionalProperties":false}},"required":["available","reason","source","sourceType","governorate","period","realEstatePriceIndex","marketActivity","dataFreshnessDays","confidence","provenance"],"additionalProperties":false}},"required":["normalizedLocation","subjectProperty","market","investment","pricePosition","comparablesSummary","riskFlags","confidence","provenance","assumptions","insufficientMarketData","unavailableOutputs","currency","dataQuality","historicalSalesContext","officialMarketContext"],"additionalProperties":false},"priorityContexts":[],"evidenceTypes":[{"type":"official_statistics","description":"officialMarketContext, when configured (NCSI), is aggregate governorate-level official statistics — kept structurally separate from property-level comparables and never blended into pricePosition."}],"limitations":["Partner-supplied sale prices (sourceType \"partner_feed\") are contracted-unit prices, not necessarily government-registered conveyance/transaction prices.","Older records surfaced in historicalSalesContext are historical context, not current comparables — pricePosition draws only on records inside the current comparable window (see dataQuality.dataFreshnessDays and each record's observedAt).","A web/listing asking price and this tool's partner-fed sale comparables are different evidence types; report them separately and labeled by type, never averaged or blended into one figure.","Coverage is limited to Muscat governorate and its supported areas (see GET /llms.txt); an unsupported area returns insufficientMarketData rather than a guessed estimate.","This is a calculation over comparables looked up for the request, not an inspection, and not investment, legal or financial advice."],"sampleQueries":[{"query":"Is this villa in Al Mouj reasonably priced?","guidance":"Call analyze_oman_property with the villa's details (area, propertyType, bedrooms, sizeSqm, askingPriceOMR). Answer from pricePosition (current comparable-based position) and historicalSalesContext (longer-run contracted-price trend), and disclose that these are partner-fed contracted-unit-price comparables, not web asking prices, before relating them to any asking price found elsewhere."},{"query":"Compare this Al Mouj asking price against local sales data","guidance":"Treat the given asking price as a web/listing-type figure (evidenceTypes.web_listing_asking_price) and this tool's pricePosition.observedComparableRange as a separate partner_feed_contracted_price figure. Report both, each labeled by evidence type, never averaged together."},{"query":"Show me recent comparable sales for a villa in Al Mouj","guidance":"Call analyze_oman_property (propertyType: villa, area: Al Mouj) and report pricePosition.observedComparableRange plus historicalSalesContext.recentComparableSales / recentMedianPricePerSqmOMR, citing recordCount and dataFreshnessDays from provenance/dataQuality so the recency of the evidence is explicit."},{"query":"Is OMR 450,000 reasonable for a 4-bedroom villa in Al Mouj?","guidance":"Call analyze_oman_property with askingPriceOMR: 450000, bedrooms: 4, propertyType: \"villa\", area: \"Al Mouj\". Answer directly from pricePosition.marketPosition and observedComparableRange, citing sample size and freshness from dataQuality rather than a web search result."}]},{"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.","whenToUse":"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.","useCases":["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"],"price":0.05,"currency":"USD","paymentProtocol":"x402","network":"eip155:8453","idempotent":true,"sideEffects":false,"endpoint":"/api/v1/business/search","x402Endpoint":"/api/v1/x402/business/search","method":"POST","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200},"governorate":{"type":"string","minLength":1,"maxLength":60},"wilayat":{"type":"string","minLength":1,"maxLength":60},"industry":{"type":"string","minLength":1,"maxLength":120},"limit":{"type":"integer","minimum":1,"maximum":50}},"required":["query"],"additionalProperties":false,"examples":[{"query":"Al Noor Trading"}]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"matches":{"type":"array","items":{"type":"object","properties":{"companyId":{"type":"string"},"companyName":{"type":"string"},"normalizedName":{"type":"string"},"legalType":{"type":["string","null"]},"industry":{"type":["string","null"]},"governorate":{"type":["string","null"]},"wilayat":{"type":["string","null"]},"status":{"type":["string","null"]},"website":{"type":["string","null"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["companyId","companyName","normalizedName","legalType","industry","governorate","wilayat","status","website","confidence"],"additionalProperties":false}},"totalMatches":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["matches","totalMatches"],"additionalProperties":false},"priorityContexts":[],"evidenceTypes":[],"limitations":[],"sampleQueries":[]},{"name":"get_oman_company_profile","description":"Return a structured profile for one Oman company by companyId — identity, registration, location and contact fields, digital-presence detection and full source provenance.","whenToUse":"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.","useCases":["get company details","look up a company's registration and contact information","check what sources back a company record"],"price":0.25,"currency":"USD","paymentProtocol":"x402","network":"eip155:8453","idempotent":true,"sideEffects":false,"endpoint":"/api/v1/business/profile","x402Endpoint":"/api/v1/x402/business/profile","method":"POST","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"companyId":{"type":"string","minLength":1,"maxLength":120}},"required":["companyId"],"additionalProperties":false,"examples":[{"companyId":"demo-co-1"}]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"company":{"type":"object","properties":{"companyId":{"type":"string"},"companyName":{"type":"string"},"legalType":{"type":["string","null"]},"status":{"type":["string","null"]},"registrationNumber":{"type":["string","null"]},"registrationDate":{"type":["string","null"]},"industry":{"type":["string","null"]},"activities":{"type":"array","items":{"type":"string"}},"governorate":{"type":["string","null"]},"wilayat":{"type":["string","null"]},"address":{"type":["string","null"]},"website":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]}},"required":["companyId","companyName","legalType","status","registrationNumber","registrationDate","industry","activities","governorate","wilayat","address","website","email","phone"],"additionalProperties":false},"digitalPresence":{"type":"object","properties":{"websiteFound":{"type":"boolean"},"domain":{"type":["string","null"]},"socialProfiles":{"type":"array","items":{"type":"string"}}},"required":["websiteFound","domain","socialProfiles"],"additionalProperties":false},"verification":{"type":"object","properties":{"verificationStatus":{"type":"string","enum":["verified","reported","estimated","inferred","stale","conflicting","unknown"]},"lastVerifiedAt":{"type":["string","null"]},"taxVerificationStatus":{"type":["string","null"]},"taxVerifiedAt":{"type":["string","null"]}},"required":["verificationStatus","lastVerifiedAt","taxVerificationStatus","taxVerifiedAt"],"additionalProperties":false},"procurement":{"type":"object","properties":{"registeredSupplier":{"type":["boolean","null"]},"supplierCategory":{"type":["string","null"]},"supplierClassification":{"type":["string","null"]},"governmentProcurementPresence":{"type":["boolean","null"]},"tendersParticipated":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"awardedContractCount":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lastTenderActivityAt":{"type":["string","null"]},"awards":{"type":"array","items":{"type":"object","properties":{"tenderNumber":{"type":"string"},"buyer":{"type":["string","null"]},"title":{"type":["string","null"]},"status":{"type":["string","null"]},"awardValueOMR":{"type":["number","null"]},"category":{"type":["string","null"]},"sourceName":{"type":"string"},"observedAt":{"type":"string"}},"required":["tenderNumber","buyer","title","status","awardValueOMR","category","sourceName","observedAt"],"additionalProperties":false}}},"required":["registeredSupplier","supplierCategory","supplierClassification","governmentProcurementPresence","tendersParticipated","awardedContractCount","lastTenderActivityAt","awards"],"additionalProperties":false},"dataCoverage":{"type":"object","properties":{"realSources":{"type":"integer","minimum":0,"maximum":9007199254740991},"demoSources":{"type":"integer","minimum":0,"maximum":9007199254740991},"latestVerifiedAt":{"type":["string","null"]}},"required":["realSources","demoSources","latestVerifiedAt"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"object","properties":{"sourceName":{"type":"string"},"sourceType":{"type":"string","enum":["government","public_registry","tax_authority","government_procurement","company_website","licensed_feed","directory","news","demo","other","admin_manual"]},"sourceAuthority":{"type":"number","minimum":0,"maximum":1},"sourceUrl":{"type":["string","null"]},"sourceRecordId":{"type":["string","null"]},"observedAt":{"type":"string"},"verificationStatus":{"type":"string","enum":["verified","reported","estimated","inferred","stale","conflicting","unknown"]},"fields":{"type":"array","items":{"type":"string"}}},"required":["sourceName","sourceType","sourceAuthority","sourceUrl","sourceRecordId","observedAt","verificationStatus","fields"],"additionalProperties":false}}},"required":["company","digitalPresence","verification","procurement","dataCoverage","sources"],"additionalProperties":false},"priorityContexts":[],"evidenceTypes":[],"limitations":[],"sampleQueries":[]},{"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.","whenToUse":"Use when an agent needs to assess whether an Oman company looks like a serious, established operating business — as a supplier, customer, partner or investment target.","useCases":["assess a company before doing business with it","supplier risk screening","partner or investor evaluation","commercial intelligence on an Oman business"],"price":0.75,"currency":"USD","paymentProtocol":"x402","network":"eip155:8453","idempotent":true,"sideEffects":false,"endpoint":"/api/v1/business/analyze","x402Endpoint":"/api/v1/x402/business/analyze","method":"POST","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"companyId":{"type":"string","minLength":1,"maxLength":120},"purpose":{"type":"string","enum":["general","supplier","customer","partner","investor"]}},"required":["companyId","purpose"],"additionalProperties":false,"examples":[{"companyId":"demo-co-1","purpose":"supplier"}]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"companyId":{"type":"string"},"commercialSignals":{"type":"object","properties":{"yearsActive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"operatingStatus":{"type":"string"},"digitalPresenceScore":{"type":"integer","minimum":0,"maximum":100},"dataCompletenessScore":{"type":"integer","minimum":0,"maximum":100},"businessMaturity":{"type":"string","enum":["new","early_stage","growing","established"]},"governmentProcurementActivity":{"type":"string","enum":["active","limited","none"]}},"required":["yearsActive","operatingStatus","digitalPresenceScore","dataCompletenessScore","businessMaturity","governmentProcurementActivity"],"additionalProperties":false},"riskFlags":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"severity":{"type":"string","enum":["low","medium","high"]},"message":{"type":"string"}},"required":["code","severity","message"],"additionalProperties":false}},"positiveSignals":{"type":"array","items":{"type":"string"}},"recommendedChecks":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number","minimum":0,"maximum":1},"confidenceReasons":{"type":"array","items":{"type":"string"}},"dataCoverage":{"type":"object","properties":{"realSources":{"type":"integer","minimum":0,"maximum":9007199254740991},"demoSources":{"type":"integer","minimum":0,"maximum":9007199254740991},"latestVerifiedAt":{"type":["string","null"]}},"required":["realSources","demoSources","latestVerifiedAt"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"object","properties":{"sourceName":{"type":"string"},"sourceType":{"type":"string","enum":["government","public_registry","tax_authority","government_procurement","company_website","licensed_feed","directory","news","demo","other","admin_manual"]},"sourceAuthority":{"type":"number","minimum":0,"maximum":1},"sourceUrl":{"type":["string","null"]},"sourceRecordId":{"type":["string","null"]},"observedAt":{"type":"string"},"verificationStatus":{"type":"string","enum":["verified","reported","estimated","inferred","stale","conflicting","unknown"]},"fields":{"type":"array","items":{"type":"string"}}},"required":["sourceName","sourceType","sourceAuthority","sourceUrl","sourceRecordId","observedAt","verificationStatus","fields"],"additionalProperties":false}}},"required":["companyId","commercialSignals","riskFlags","positiveSignals","recommendedChecks","confidence","confidenceReasons","dataCoverage","sources"],"additionalProperties":false},"priorityContexts":[],"evidenceTypes":[],"limitations":[],"sampleQueries":[]},{"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.","whenToUse":"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.","useCases":["pre-contract supplier due diligence","partnership due diligence","investment due diligence","customer credit risk screening"],"price":2,"currency":"USD","paymentProtocol":"x402","network":"eip155:8453","idempotent":true,"sideEffects":false,"endpoint":"/api/v1/business/due-diligence","x402Endpoint":"/api/v1/x402/business/due-diligence","method":"POST","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"companyId":{"type":"string","minLength":1,"maxLength":120},"transactionType":{"type":"string","enum":["supplier_contract","partnership","investment","customer_credit","other"]},"transactionValueOMR":{"type":"number","minimum":0,"maximum":1000000000}},"required":["companyId","transactionType"],"additionalProperties":false,"examples":[{"companyId":"demo-co-1","transactionType":"supplier_contract","transactionValueOMR":50000}]},"outputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"company":{"type":"object","properties":{"companyId":{"type":"string"},"companyName":{"type":"string"},"legalType":{"type":["string","null"]},"status":{"type":["string","null"]},"registrationNumber":{"type":["string","null"]},"registrationDate":{"type":["string","null"]},"industry":{"type":["string","null"]},"activities":{"type":"array","items":{"type":"string"}},"governorate":{"type":["string","null"]},"wilayat":{"type":["string","null"]},"address":{"type":["string","null"]},"website":{"type":["string","null"]},"email":{"type":["string","null"]},"phone":{"type":["string","null"]}},"required":["companyId","companyName","legalType","status","registrationNumber","registrationDate","industry","activities","governorate","wilayat","address","website","email","phone"],"additionalProperties":false},"verification":{"type":"object","properties":{"identityVerified":{"type":"boolean"},"status":{"type":["string","null"]},"registrationAgeYears":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"verificationStatus":{"type":"string","enum":["verified","reported","estimated","inferred","stale","conflicting","unknown"]},"lastVerifiedAt":{"type":["string","null"]},"taxVerificationStatus":{"type":["string","null"]},"taxVerifiedAt":{"type":["string","null"]}},"required":["identityVerified","status","registrationAgeYears","verificationStatus","lastVerifiedAt","taxVerificationStatus","taxVerifiedAt"],"additionalProperties":false},"procurement":{"type":"object","properties":{"registeredSupplier":{"type":["boolean","null"]},"supplierCategory":{"type":["string","null"]},"supplierClassification":{"type":["string","null"]},"governmentProcurementPresence":{"type":["boolean","null"]},"tendersParticipated":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"awardedContractCount":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lastTenderActivityAt":{"type":["string","null"]},"awards":{"type":"array","items":{"type":"object","properties":{"tenderNumber":{"type":"string"},"buyer":{"type":["string","null"]},"title":{"type":["string","null"]},"status":{"type":["string","null"]},"awardValueOMR":{"type":["number","null"]},"category":{"type":["string","null"]},"sourceName":{"type":"string"},"observedAt":{"type":"string"}},"required":["tenderNumber","buyer","title","status","awardValueOMR","category","sourceName","observedAt"],"additionalProperties":false}}},"required":["registeredSupplier","supplierCategory","supplierClassification","governmentProcurementPresence","tendersParticipated","awardedContractCount","lastTenderActivityAt","awards"],"additionalProperties":false},"commercialAssessment":{"type":"object","properties":{"operationalMaturity":{"type":"string","enum":["new","early_stage","growing","established"]},"digitalFootprint":{"type":"string","enum":["strong","moderate","weak","none"]},"publicInformationCoverage":{"type":"string","enum":["high","medium","low"]},"governmentProcurementActivity":{"type":"string","enum":["active","limited","none"]}},"required":["operationalMaturity","digitalFootprint","publicInformationCoverage","governmentProcurementActivity"],"additionalProperties":false},"riskAssessment":{"type":"object","properties":{"riskLevel":{"type":"string","enum":["low","medium","high"]},"riskScore":{"type":"integer","minimum":0,"maximum":100},"riskFlags":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"severity":{"type":"string","enum":["low","medium","high"]},"message":{"type":"string"}},"required":["code","severity","message"],"additionalProperties":false}}},"required":["riskLevel","riskScore","riskFlags"],"additionalProperties":false},"recommendedDueDiligence":{"type":"array","items":{"type":"object","properties":{"check":{"type":"string"},"importance":{"type":"string","enum":["low","medium","high"]}},"required":["check","importance"],"additionalProperties":false}},"missingInformation":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number","minimum":0,"maximum":1},"confidenceReasons":{"type":"array","items":{"type":"string"}},"dataCoverage":{"type":"object","properties":{"realSources":{"type":"integer","minimum":0,"maximum":9007199254740991},"demoSources":{"type":"integer","minimum":0,"maximum":9007199254740991},"latestVerifiedAt":{"type":["string","null"]}},"required":["realSources","demoSources","latestVerifiedAt"],"additionalProperties":false},"sources":{"type":"array","items":{"type":"object","properties":{"sourceName":{"type":"string"},"sourceType":{"type":"string","enum":["government","public_registry","tax_authority","government_procurement","company_website","licensed_feed","directory","news","demo","other","admin_manual"]},"sourceAuthority":{"type":"number","minimum":0,"maximum":1},"sourceUrl":{"type":["string","null"]},"sourceRecordId":{"type":["string","null"]},"observedAt":{"type":"string"},"verificationStatus":{"type":"string","enum":["verified","reported","estimated","inferred","stale","conflicting","unknown"]},"fields":{"type":"array","items":{"type":"string"}}},"required":["sourceName","sourceType","sourceAuthority","sourceUrl","sourceRecordId","observedAt","verificationStatus","fields"],"additionalProperties":false}}},"required":["company","verification","procurement","commercialAssessment","riskAssessment","recommendedDueDiligence","missingInformation","confidence","confidenceReasons","dataCoverage","sources"],"additionalProperties":false},"priorityContexts":[],"evidenceTypes":[],"limitations":[],"sampleQueries":[]}],"meta":{"requestId":"1f1e7f1e-8bcd-4c4f-83e6-4651ec7de330"}}