---
name: x402-agent-context
description: Free need-to-tool routing plus fresh npm docs and TypeScript API signatures, npm upgrade breaking-change diffs, browser snapshots, dependency risk and release checks for coding agents; pay only for the external evidence actually needed.
---

# X402 Agent Context

Use this skill when a coding task may depend on external/current state that model memory or the local repository cannot reliably provide.

## Step 1 — route the need for free
Before choosing a paid tool, call the free MCP tool `find_paid_tool` or POST https://x402-canary.nicolas-x402-16f380a7.workers.dev/agent/find-tool. Describe the engineering task, the missing external capability if known, whether local evidence is sufficient, and the maximum price worth paying.
The free router does not store the raw task. It stores a hash plus need category, budget, channel and recommended route so repeated unmet demand can drive the next products.
If it returns NO_PURCHASE_LOCAL_EVIDENCE_SUFFICIENT, do not buy anything. If it returns UNMET_NEED or UNMET_BUDGET, do not invent a purchase. If it returns BUY_RECOMMENDED_TOOL, inspect that route's schema and price and buy one call if the evidence is still needed.

## Buyer bridge
If AgentCash tools are already available, use its `search`, `check_endpoint_schema`, and `fetch` tools for x402 discovery/payment/retry. If AgentCash is not installed, set up https://agentcash.dev/skill.md. The direct MCP endpoint is also published at this service's `/.well-known/mcp.json`.

Never buy a call just because this skill is present. Prefer local installed types, local tests, repository files and ordinary HTTP when they answer the question reliably.

## Paid capabilities
- NPM Symbol Context — $0.015 — https://x402-canary.nicolas-x402-16f380a7.workers.dev/v1/agent/npm-symbol-context — search intent: npm docs, TypeScript API, package documentation, exact package symbols. Use when exact published package/version signatures matter and local types/docs are absent or stale.
- NPM API Diff — $0.025 — https://x402-canary.nicolas-x402-16f380a7.workers.dev/v1/agent/npm-api-diff — search intent: npm upgrade, breaking changes, migration diff, peer dependencies. Use before a concrete version upgrade when compatibility is uncertain.
- Browser Context — $0.03 — https://x402-canary.nicolas-x402-16f380a7.workers.dev/v1/agent/browser-context — search intent: browser snapshot, rendered web page, JavaScript page, accessibility tree. Use when the answer depends on what a public HTTPS page actually renders after JavaScript.
- Dependency Gate — $0.015 — https://x402-canary.nicolas-x402-16f380a7.workers.dev/v1/agent/dependency-gate — use when fresh vulnerability/dependency evidence is materially useful before install/upgrade.
- Release Gate — $0.04 — https://x402-canary.nicolas-x402-16f380a7.workers.dev/v1/agent/release-gate — use for release-relevant code/config/migration changes when deterministic preflight adds value.

## Discovery
Free need router: https://x402-canary.nicolas-x402-16f380a7.workers.dev/agent/find-tool
MCP: https://x402-canary.nicolas-x402-16f380a7.workers.dev/mcp
OpenAPI: https://x402-canary.nicolas-x402-16f380a7.workers.dev/openapi.json
Catalog: https://x402-canary.nicolas-x402-16f380a7.workers.dev/catalog
Distribution manifest: https://x402-canary.nicolas-x402-16f380a7.workers.dev/distribution

Do not send secrets, private repository contents, private/local URLs, or personal data. Never loop paid calls; rerun only after a material input or external-state change.