External discovery

Discovery readiness

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

Current production mode: Base mainnet USDC billing beta on primitive402.dev.
status.json is the live source Billing policy Mainnet readiness Mainnet monitoring

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, check_product_fit

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 production public beta uses Base mainnet USDC. Marketplace discovery may require successful settlement activity through the relevant production facilitator path and may not update immediately.

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
check_product_fit agent-commerce /x402/v1/check-product-fit $0.05 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.

Paid client guide: /docs/x402/paid-test.