External discovery

Discovery readiness

Verify that Primitive402 paid endpoints are discoverable, semantically described, correctly priced, and ready for external x402 marketplace indexing.

Self-hosted discovery surfaces

Primitive402 publishes route, schema, pricing, x402, Bazaar-style, LLM-readable, and agent-manifest metadata from the same route catalog.

How agents discover tools

Agents can inspect stable machine names, descriptions, schemas, local routes, x402 routes, prices, tags, safety notes, MCP names, and SDK methods before deciding which Primitive402 tool to call.

safe_fetch_url, check_prompt_injection_risk, verify_claim_against_source, create_page_proof, extract_return_policy, extract_subscription_terms

x402 and Bazaar-style readiness

Unpaid /x402/v1/* requests should return HTTP 402 Payment Required with payment metadata including network, amount, asset, payTo, resource URL, resource description, MIME type, and Bazaar extension metadata when available.

The current public beta uses Base Sepolia testnet USDC. Production or mainnet marketplace discovery may require a production facilitator or provider path and successful settlement activity through the relevant discovery system.

Current categorization

ToolCategoryx402 routePrice
safe_fetch_url agent-safety /x402/v1/safe-fetch-url $0.01 USDC
check_prompt_injection_risk agent-safety /x402/v1/check-prompt-injection-risk $0.005 USDC
verify_claim_against_source agent-safety /x402/v1/verify-claim-against-source $0.05 USDC
create_page_proof agent-safety /x402/v1/create-page-proof $0.10 USDC
extract_return_policy agent-commerce /x402/v1/extract-return-policy $0.03 USDC
extract_subscription_terms agent-commerce /x402/v1/extract-subscription-terms $0.04 USDC

Run the readiness check

pnpm discovery:check --baseUrl https://primitive402.dev

The checker verifies all self-hosted discovery files, rich agent manifest entries, local and x402 OpenAPI paths, unpaid 402 responses, resource URLs, prices, and Bazaar categories.

External indexing status

  • Current: Primitive402 self-hosted discovery surfaces are live and generated from the route catalog.
  • Next: verify external Bazaar or Agentic.Market-style listing requirements with provider-specific tools or APIs.
  • Important: external indexing can be asynchronous and may depend on successful settlement, facilitator support, metadata ingestion rules, or provider credentials.

Read more

Repository guide: docs/discovery/bazaar-readiness.md.