multi_source_search
Run a single unified Valyu-style search across Oman companies, government procurement awards, Oman property comparables, and optional live web pages, returning relevance-ranked, citation-backed results.
When to use
Use when an agent wants cross-vertical evidence (companies, tenders, real estate, and web) in one call with responseLength context control and explicit primary-source grounding tiers.
Selection guidance
Role: supporting. Use when an agent wants cross-vertical evidence (companies, tenders, real estate, and web) in one call with responseLength context control and explicit primary-source grounding tiers.
Use cases
- unified multi-source research in one call
- context-budgeted agent grounding
- cross-domain Oman company, tender and property lookup
Access
- REST:
POST https://api.rafidsystem.com/api/v1/intelligence/multi-source-search - x402:
POST https://api.rafidsystem.com/api/v1/x402/intelligence/multi-source-search - MCP tool:
multi_source_search
Price: $0.35 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.
Get the full result
0.35 USD per call
Pay with USDC · request an x402 challenge
curl -X POST 'https://api.rafidsystem.com/api/v1/x402/intelligence/multi-source-search' -H 'Content-Type: application/json' --data '{"query":"Al Noor Trading","sources":["oman_companies","oman_procurement"],"responseLength":"medium","maxResults":5}'Authorized x402 client · signed retry request
curl -X POST 'https://api.rafidsystem.com/api/v1/x402/intelligence/multi-source-search' -H 'Content-Type: application/json' -H 'PAYMENT-SIGNATURE: <PAYMENT_SIGNATURE_FROM_AUTHORIZED_CLIENT>' -H 'X-Rafid-Payment-Journey: <PAYMENT_JOURNEY_FROM_CHALLENGE>' -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' --data '{"query":"Al Noor Trading","sources":["oman_companies","oman_procurement"],"responseLength":"medium","maxResults":5}'Use an x402-compatible client to parse PAYMENT-REQUIRED and authorize payment before retrying the same input with PAYMENT-SIGNATURE. Copying a request does not pay.
No crypto wallet? Use Rafid Credits
curl -X POST 'https://api.rafidsystem.com/api/v1/intelligence/multi-source-search' -H 'Content-Type: application/json' -H 'Authorization: Bearer <RAFID_API_KEY>' -H 'X-Rafid-Payment-Method: credits' -H 'Idempotency-Key: <UNIQUE_REQUEST_ID>' -H 'X-Rafid-Payment-Journey: <PAYMENT_JOURNEY_FROM_CHALLENGE>' --data '{"query":"Al Noor Trading","sources":["oman_companies","oman_procurement"],"responseLength":"medium","maxResults":5}'Create an API key instantly via POST https://api.rafidsystem.com/api/v1/account/signup or at https://api.rafidsystem.com/get-started, then fund by card (Stripe) or USDC and save with monthly plans ($10–$500/mo).
Existing account balance: GET https://api.rafidsystem.com/api/v1/account/balance.
MCP Credits integration
POST https://api.rafidsystem.com/mcp/credits
Authorization: Bearer <OAUTH_ACCESS_TOKEN>
Idempotency-Key: <UNIQUE_REQUEST_ID>
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "multi_source_search",
"arguments": {
"query": "Al Noor Trading",
"sources": [
"oman_companies",
"oman_procurement"
],
"responseLength": "medium",
"maxResults": 5
}
}
}OAuth metadata: authorization server · protected resource. Operator authorization and an existing funded account are required; OAuth does not grant credits.
Payment instructions and onboarding · API docs and schemas
These are copyable API integration requests. They do not open a checkout or execute a paid tool.
Related tools
- company_risk_batch
- company_risk_report
- due_diligence_oman_company
- business_risk_score
- company_reputation_check
- research_company
- analyze_company_risk
Example input
{
"query": "Al Noor Trading",
"sources": [
"oman_companies",
"oman_procurement"
],
"responseLength": "medium",
"maxResults": 5
}Example output
{
"query": "Al Noor Trading",
"sourcesQueried": [
"oman_companies",
"oman_procurement"
],
"responseLength": "medium",
"totalResults": 1,
"results": [
{
"id": "company:demo-co-1",
"source": "oman_companies",
"title": "Al Noor Trading & Contracting LLC",
"summary": "Al Noor Trading & Contracting LLC (active) — Muscat.",
"relevanceScore": 0.94,
"confidence": 0.94,
"groundingTier": "demo_dataset",
"citation": {
"sourceName": "rafid-demo",
"sourceType": "demo",
"sourceUrl": null,
"observedAt": "2026-01-01T00:00:00.000Z"
}
}
]
}Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"sources": {
"minItems": 1,
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"enum": [
"oman_companies",
"oman_procurement",
"oman_property",
"web"
]
}
},
"responseLength": {
"type": "string",
"enum": [
"short",
"medium",
"large"
]
},
"maxResults": {
"type": "integer",
"minimum": 1,
"maximum": 30
},
"governorate": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"propertyType": {
"type": "string",
"enum": [
"apartment",
"villa",
"townhouse"
]
},
"webUrl": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"fields": {
"minItems": 1,
"maxItems": 40,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
},
"outputSchema": {
"type": "object",
"propertyNames": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"additionalProperties": {
"type": "string",
"minLength": 1,
"maxLength": 120
}
}
},
"required": [
"query"
],
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"query": {
"type": "string"
},
"sourcesQueried": {
"type": "array",
"items": {
"type": "string",
"enum": [
"oman_companies",
"oman_procurement",
"oman_property",
"web"
]
}
},
"responseLength": {
"type": "string",
"enum": [
"short",
"medium",
"large"
]
},
"totalResults": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"source": {
"type": "string",
"enum": [
"oman_companies",
"oman_procurement",
"oman_property",
"web"
]
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"relevanceScore": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"confidence": {
"type": "number",
"minimum": 0,
"maximum": 1
},
"groundingTier": {
"type": "string",
"enum": [
"verified_primary_source",
"market_comparable",
"web_extract",
"demo_dataset"
]
},
"citation": {
"type": "object",
"properties": {
"sourceName": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"sourceUrl": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": "string"
}
},
"required": [
"sourceName",
"sourceType",
"sourceUrl",
"observedAt"
],
"additionalProperties": false
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"required": [
"id",
"source",
"title",
"summary",
"relevanceScore",
"confidence",
"groundingTier",
"citation"
],
"additionalProperties": false
}
},
"tableRows": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"required": [
"query",
"sourcesQueried",
"responseLength",
"totalResults",
"results"
],
"additionalProperties": false
}Category: Company & Risk Intelligence · hierarchy: supporting · idempotent: yes · side effects: no