Install
openclaw skills install oraclenet-meshOraclenet Mesh
OracleNet is a mesh capability router for autonomous agents. Use when an agent needs to discover, route, verify, or pay for external capabilities through ToolOracle's machine-readable mesh — for example: blockchain intelligence, market and macro data, GPU pricing, research, sanctions screening, signed structured outputs, or optional regulated-evidence routing. Not a tool list. Not a single product. A routing layer.
OracleNet — Mesh Capability Router
A machine-readable entry point for autonomous agents to discover, route, verify, and (where supported) pay for external capabilities.
OracleNet is not a tool list and not a single product. It is a routing layer. An agent describes what it needs in natural language; OracleNet classifies the intent and returns a recommended capability route, along with available pricing, verification, and contact metadata.
- Identity:
did:web:tooloracle.io - Primary discovery card:
https://tooloracle.io/.well-known/agent.json - Live mesh snapshot:
https://tooloracle.io/.well-known/agent-pulse - Generic agent skill:
https://tooloracle.io/skill.md
When to use this skill
Use OracleNet when an agent needs:
- Blockchain intelligence across multiple chains (read-only data, risk signals, DEX/DeFi state)
- Research and external API access without integrating dozens of providers individually
- Verification metadata for structured outputs (signatures and content hashes, where supported)
- Workflow enrichment (macro data, news, jobs, weather, maps, search)
- Compute discovery (GPU pricing and availability)
- Market and macro intelligence (FX, rates, commodities, indices)
- Optional regulated-evidence capabilities — available as a routed sub-layer (FeedOracle), explicitly opt-in. Most agents will not need it.
OracleNet returns structured data; interpretation is the agent's responsibility. It is not a substitute for legal, financial, or compliance advice.
First call: soft handshake
The recommended first contact is a free, stateless soft handshake. No auth, no payment, no registration:
curl -X POST https://tooloracle.io/handshake \
-H "Content-Type: application/json" \
-d '{"intent":"<one sentence describing what you need>"}'
The response includes a recommended oracle, a routing block with one or
more endpoints, and suggested next_steps. The handshake is intended for
machine-readable use only.
After the handshake — discovery files
Read these. They are static, cached at the edge, and free to fetch:
| File | Purpose |
|---|---|
https://tooloracle.io/.well-known/deal-capabilities.json | Supported interaction types and rules |
https://tooloracle.io/.well-known/pricing.json | What is free, what may incur a charge |
https://tooloracle.io/.well-known/rewards.json | Originator and referrer credit model (policy + enforcement status) |
https://tooloracle.io/.well-known/verification-policy.json | Issuer, JWKS, signature handling |
https://tooloracle.io/.well-known/do-not-contact.json | Domains and DIDs that must not be contacted |
https://tooloracle.io/.well-known/agent-pulse | Live mesh snapshot (servers, tools, gravity score) |
Treat each enforcement_status field as authoritative. Where it says
partial, planned, or may_be_available, do not assume the mechanism is
fully operational on every route.
Connecting OracleNet as an MCP server
OracleNet exposes a single LLM-routed MCP entry point:
# IronClaw / OpenClaw
ironclaw mcp add oraclenet https://tooloracle.io/quantum/mcp/
# Other MCP-aware agents: register the URL in your usual MCP config
After this, the agent can call quantum_intent with a natural-language
description and OracleNet will route to the appropriate underlying oracle.
Payment
A free tier is available without registration; specifics are route-dependent. Where a paid call is required, settlement uses the x402 protocol with USDC on Base. Common baseline is 0.01 USD per call, but per-tool overrides apply — consult the per-tool MCP card.
Machine-to-machine access is designed around x402 and usage units. Any legacy human checkout references are outside this agent pricing policy.
Verification
curl https://tooloracle.io/.well-known/jwks.json
Where the per-tool MCP card declares signing support, the response carries
a signature (transport varies by tool — headers, body metadata, or
endpoint-specific receipts). The current JWKS is shared with the FeedOracle
layer (legacy state); a dedicated ToolOracle issuer key is planned but not
yet deployed. Verifiers should consult verification-policy.json for
authoritative guidance.
Rewards and originator credits
OracleNet credits the agent that first surfaces a capability and the agent
that brings new paying users. Settlement is in usage units, not cash.
See rewards.json for current categories and per-mechanism
enforcement_status. Some mechanisms are policy-declared with partial
enforcement and are still being hardened.
Rules of engagement
- OracleNet respects
https://tooloracle.io/.well-known/do-not-contact.jsonfor any outbound flow - OracleNet does not initiate human outreach. Targets must be machine-readable
- Rate limits are route-specific and may be published in endpoint headers or MCP cards
- Opt-out is supported via the machine-readable inbox at
https://tooloracle.io/a2a/inbox(consult inbox metadata before posting)
What OracleNet does not claim
- Not an official NEAR partner or NEAR-integrated product
- Not affiliated with OpenClaw, IronClaw, or NEAR.ai as a partnership
- Does not guarantee that every listed capability is paid-call-ready in every interaction
- Does not provide investment, legal, or compliance advice
- Does not certify regulatory status for any third party
Optional: regulated-evidence layer
For regulated-evidence flows (for example MiCA, DORA, AMLR scoring with full
evidence bundles), OracleNet routes to the FeedOracle sub-layer, which has
its own pricing and terms. Most agents will not need this. See pricing.json → tiers.evidence_response if it comes up.
Quick reference
| Need | URL |
|---|---|
| Soft handshake | POST https://tooloracle.io/handshake |
| Capabilities & rules | https://tooloracle.io/.well-known/deal-capabilities.json |
| Pricing | https://tooloracle.io/.well-known/pricing.json |
| Rewards | https://tooloracle.io/.well-known/rewards.json |
| Verification | https://tooloracle.io/.well-known/verification-policy.json |
| JWKS | https://tooloracle.io/.well-known/jwks.json |
| Do-not-contact | https://tooloracle.io/.well-known/do-not-contact.json |
| Live mesh snapshot | https://tooloracle.io/.well-known/agent-pulse |
| Agent card (A2A v0.3) | https://tooloracle.io/.well-known/agent.json |
| Generic skill (NEAR/Agent-Market style) | https://tooloracle.io/skill.md |
| MCP entry point | https://tooloracle.io/quantum/mcp/ |
| Partnership inbox (machine, supports opt_out) | https://tooloracle.io/a2a/inbox |