XGuard — Payment Decision & Discovery
Payment decisions, durable evidence, x402 resource discovery and live gateway status for AI agents.
Should I use this
Quality & Safety
Findings (5)
- LOWin xguard.fact.get
- LOWin xguard.capabilities
- LOWin xguard.preflight
- LOWin xguard.pricing.quote
- LOWin xguard.web.fetch
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"xguard": {
"url": "https://xguard-mainnet.maqamapp.workers.dev/mcp"
}
}
}Remote endpoints
https://xguard-mainnet.maqamapp.workers.dev/mcpstreamable-httphttps://xguardgate.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢xguard.fact.get(factId)
Read one free published software fact by canonical ID. Returns the primary source, verification status and timestamp. Use xguard.web.fetch for a separate paid fetch of a public URL.
Input Schema
{
"type": "object",
"properties": {
"factId": {
"type": "string",
"maxLength": 350,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]*(?:/[@A-Za-z0-9][A-Za-z0-9_.-]*){2,3}$",
"description": "Canonical fact ID, for example npm/react/latest-version"
}
},
"required": [
"factId"
],
"additionalProperties": false
}🟢xguard.capabilities
Return the enabled and disabled XGuard tools, their security boundary, and canonical discovery URLs. Free.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢xguard.preflight
Free, read-only safety gate for xguard.web.fetch. Validates the public HTTPS target, SSRF policy, DNS reachability and selected payment path without contacting the target or attempting payment. On allow, call xguard.web.fetch directly; it creates the signed quote and returns the mandatory x402 v2 PaymentRequired result.
Input Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"input"
],
"properties": {
"tool": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"toolName": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"tool_name": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capability": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capability_id": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capabilityId": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"input": {
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"capability",
"input"
],
"properties": {
"capability": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capability_id": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capabilityId": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"input": {
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"name",
"arguments"
],
"properties": {
"name": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"arguments": {
"oneOf": [
{
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "string",
"contentMediaType": "application/json"
}
]
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"tool_name",
"parameters"
],
"properties": {
"tool_name": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"toolName": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"parameters": {
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"function"
],
"properties": {
"function": {
"type": "object",
"required": [
"name",
"arguments"
],
"properties": {
"name": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"arguments": {
"oneOf": [
{
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "string",
"contentMediaType": "application/json"
}
]
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
}
],
"description": "Canonical form is a flat object with url. Explicitly supported agent envelopes are documented in x-xguard-accepted-shapes.",
"x-xguard-accepted-shapes": [
{
"name": "canonical_flat",
"example": {
"url": "https://example.com/",
"method": "GET",
"testnet": true
}
},
{
"name": "tool_input",
"example": {
"tool": "xguard.web.fetch",
"input": {
"url": "https://example.com/",
"method": "GET"
},
"testnet": true
}
},
{
"name": "mcp_arguments",
"example": {
"name": "xguard.web.fetch",
"arguments": {
"url": "https://example.com/",
"method": "GET"
},
"testnet": true
}
},
{
"name": "tool_parameters",
"example": {
"tool_name": "xguard.web.fetch",
"parameters": {
"url": "https://example.com/",
"method": "GET"
},
"network": "eip155:84532"
}
},
{
"name": "function_call",
"example": {
"function": {
"name": "xguard.web.fetch",
"arguments": "{\"url\":\"https://example.com/\",\"method\":\"GET\"}"
},
"testnet": true
}
},
{
"name": "curl_command",
"example": {
"command": "curl https://example.com/",
"testnet": true
}
},
{
"name": "operation_object",
"example": {
"operation": {
"name": "xguard.web.fetch",
"arguments": {
"endpoint": "https://example.com/",
"method": "GET"
}
},
"testnet": true
}
}
]
}🟢xguard.pricing.quote
Get an optional signed quote for xguard.web.fetch. Call xguard.web.fetch directly to receive the price in an HTTP 402 challenge.
Input Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"input"
],
"properties": {
"tool": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"toolName": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"tool_name": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capability": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capability_id": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capabilityId": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"input": {
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"capability",
"input"
],
"properties": {
"capability": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capability_id": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"capabilityId": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"input": {
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"name",
"arguments"
],
"properties": {
"name": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"arguments": {
"oneOf": [
{
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "string",
"contentMediaType": "application/json"
}
]
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"tool_name",
"parameters"
],
"properties": {
"tool_name": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"toolName": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"parameters": {
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"function"
],
"properties": {
"function": {
"type": "object",
"required": [
"name",
"arguments"
],
"properties": {
"name": {
"type": "string",
"enum": [
"xguard.web.fetch",
"web.fetch",
"fetch",
"xguard_web_fetch"
]
},
"arguments": {
"oneOf": [
{
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"testnet": {
"type": "boolean",
"default": false
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
},
{
"type": "string",
"contentMediaType": "application/json"
}
]
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
}
},
"additionalProperties": true
}
],
"description": "Canonical form is a flat object with url. Explicitly supported agent envelopes are documented in x-xguard-accepted-shapes.",
"x-xguard-accepted-shapes": [
{
"name": "canonical_flat",
"example": {
"url": "https://example.com/",
"method": "GET",
"testnet": true
}
},
{
"name": "tool_input",
"example": {
"tool": "xguard.web.fetch",
"input": {
"url": "https://example.com/",
"method": "GET"
},
"testnet": true
}
},
{
"name": "mcp_arguments",
"example": {
"name": "xguard.web.fetch",
"arguments": {
"url": "https://example.com/",
"method": "GET"
},
"testnet": true
}
},
{
"name": "tool_parameters",
"example": {
"tool_name": "xguard.web.fetch",
"parameters": {
"url": "https://example.com/",
"method": "GET"
},
"network": "eip155:84532"
}
},
{
"name": "function_call",
"example": {
"function": {
"name": "xguard.web.fetch",
"arguments": "{\"url\":\"https://example.com/\",\"method\":\"GET\"}"
},
"testnet": true
}
},
{
"name": "curl_command",
"example": {
"command": "curl https://example.com/",
"testnet": true
}
},
{
"name": "operation_object",
"example": {
"operation": {
"name": "xguard.web.fetch",
"arguments": {
"endpoint": "https://example.com/",
"method": "GET"
}
},
"testnet": true
}
}
]
}🟢xguard.web.fetch
Fetch one public HTTPS resource after x402 v2 payment and on-chain settlement verification. Retry the identical MCP call with Payment-Signature and X-XGuard-Quote. A completed retry returns the prior receipt.
Input Schema
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"quote"
],
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
},
"quote": {
"type": "string",
"description": "Compact signed quote returned by xguard.pricing.quote."
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"tool",
"input"
],
"properties": {
"tool": {
"type": "string",
"enum": [
"xguard.web.fetch"
]
},
"input": {
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
},
"quote": {
"type": "string",
"description": "Compact signed quote returned by xguard.pricing.quote."
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"name",
"arguments"
],
"properties": {
"name": {
"type": "string",
"enum": [
"xguard.web.fetch"
]
},
"arguments": {
"oneOf": [
{
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
}
},
"additionalProperties": true
},
{
"type": "string",
"contentMediaType": "application/json"
}
]
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
},
"quote": {
"type": "string",
"description": "Compact signed quote returned by xguard.pricing.quote."
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"tool_name",
"parameters"
],
"properties": {
"tool_name": {
"type": "string",
"enum": [
"xguard.web.fetch"
]
},
"parameters": {
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
}
},
"additionalProperties": true
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
},
"quote": {
"type": "string",
"description": "Compact signed quote returned by xguard.pricing.quote."
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"function"
],
"properties": {
"function": {
"type": "object",
"required": [
"name",
"arguments"
],
"properties": {
"name": {
"type": "string",
"enum": [
"xguard.web.fetch"
]
},
"arguments": {
"oneOf": [
{
"type": "object",
"anyOf": [
{
"required": [
"url"
]
},
{
"required": [
"target_url"
]
},
{
"required": [
"targetUrl"
]
},
{
"required": [
"uri"
]
},
{
"required": [
"target"
]
},
{
"required": [
"resource"
]
},
{
"required": [
"endpoint"
]
},
{
"required": [
"href"
]
},
{
"required": [
"curl"
]
},
{
"required": [
"command"
]
},
{
"required": [
"operation"
]
},
{
"required": [
"action"
]
}
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"description": "Canonical public HTTPS target URL."
},
"target_url": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"targetUrl": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"uri": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"target": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"resource": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"endpoint": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"href": {
"type": "string",
"format": "uri",
"pattern": "^https://",
"deprecated": true,
"description": "Accepted alias for url."
},
"curl": {
"type": "string",
"description": "One deterministic curl GET/HEAD command containing one absolute HTTPS URL."
},
"command": {
"type": "string",
"description": "Alias for curl."
},
"operation": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "OpenAPI/MCP-style operation envelope."
},
"action": {
"oneOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Action envelope."
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD"
],
"default": "GET"
},
"timeout_ms": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"default": 8000
},
"timeoutMs": {
"type": "integer",
"minimum": 1000,
"maximum": 10000,
"deprecated": true
},
"max_bytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"default": 131072
},
"maxBytes": {
"type": "integer",
"minimum": 1024,
"maximum": 131072,
"deprecated": true
},
"mode": {
"type": "string",
"enum": [
"auto",
"text",
"json"
],
"default": "auto"
}
},
"additionalProperties": true
},
{
"type": "string",
"contentMediaType": "application/json"
}
]
}
},
"additionalProperties": false
},
"testnet": {
"type": "boolean"
},
"network": {
"type": "string",
"enum": [
"eip155:8453",
"eip155:84532",
"base",
"base-mainnet",
"base-sepolia",
"mainnet",
"testnet"
]
},
"quote": {
"type": "string",
"description": "Compact signed quote returned by xguard.pricing.quote."
}
},
"additionalProperties": true
}
],
"description": "Canonical and common AI-agent envelopes are accepted. A first call without a quote returns HTTP 402 plus an automatically created signed quote. Retry the identical request with X-XGuard-Quote and Payment-Signature.",
"x-xguard-accepted-shapes": [
"canonical_flat",
"tool_input",
"mcp_arguments",
"tool_parameters",
"function_call",
"curl_command",
"operation_object"
]
}Community
Evidence