kya_web_fetch

Fetch a web page with your Badge identity attached. Your Kya-Token header is injected automatically — merchants see you as an authorized actor, not a bot. Your visit is automatically recorded in your shopping journal. Call kya_getAgentIdentity first. Then use this instead of web_fetch when shoppi...

Server Payclaw kyalabs-io/mcp-server
Category Execute
Risk class High
Parameters 00 required

What kya_web_fetch does on Payclaw

AI agents invoke kya_web_fetch to trigger actions in Payclaw. What it does depends on the arguments the agent supplies, and its effects often reach beyond the immediate call — builds kicked off, notifications sent, workflows started.

Why kya_web_fetch needs a policy

This tool does more than a passive read: it injects authentication tokens into HTTP requests, presents the agent as an authorized actor to merchant sites, and automatically records activity in a shopping journal. These side effects (identity assertion, session establishment with merchants, audit trail creation) elevate it beyond a simple Read.

From the tool's definition 'Fetch a web page with your Badge identity attached. Your Kya-Token header is injected automatically — merchants see you as an authorized actor, not a bot. Your visit is automatically recorded in your shopping journal.'

Questions about kya_web_fetch

What does the kya_web_fetch tool do? +

Fetch a web page with your Badge identity attached. Your Kya-Token header is injected automatically — merchants see you as an authorized actor, not a bot. Your visit is automatically recorded in your shopping journal. Call kya_getAgentIdentity first. Then use this instead of web_fetch when shopping at merchant sites. HTTPS only. Returns status, headers, and body (5MB max, 30s timeout). Redirects are not followed — check the Location header if you receive a 3xx status. It is categorised as a Execute tool in the Payclaw MCP Server, which means it can trigger actions or run processes. Use rate limits and argument validation.

How do I enforce a policy on kya_web_fetch? +

Register the Payclaw MCP server in PolicyLayer and add a rule for kya_web_fetch: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Payclaw. Nothing to install.

What risk level is kya_web_fetch? +

kya_web_fetch is a Execute tool with high risk. Execute tools should be rate-limited and have argument validation enabled.

Can I rate-limit kya_web_fetch? +

Yes. Add a rate_limit block to the kya_web_fetch rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block kya_web_fetch completely? +

Set action: deny in the PolicyLayer policy for kya_web_fetch. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides kya_web_fetch? +

kya_web_fetch is provided by the Payclaw MCP server (kyalabs-io/mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.