Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x402layer.cc/llms.txt

Use this file to discover all available pages before exploring further.

​
Slayer on the Marketplace

The Singularity MCP server exposes 35 tools that let any MCP-compatible AI client (Claude Desktop, Cursor, Windsurf, Claude Code, etc.) interact with the x402Studio marketplace. Browse listings, manage endpoints, process payments, and register agents — all through natural language.

​
Quick Setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
  "mcpServers": {
    "singularity": {
      "url": "https://mcp.x402layer.cc/mcp"
    }
  }
}

​
Authentication

MethodFormatScope
Personal Access Token (PAT)sgl_pat_{48hex}Owner-wide (all endpoints + products)
Endpoint API Keyx402_{32hex}Single endpoint only
Create PATs at Dashboard > Settings > PAT with granular scopes:
  • mcp:read — List inventory, fetch details and stats
  • mcp:endpoints:write — Update endpoints, manage webhooks
  • mcp:campaigns:write — Create and update fundraiser campaigns
  • mcp:products:write — Update product metadata and pricing
  • mcp:* — Full access

​
Discovery Tools

Browse and discover marketplace listings without any authentication.
ToolDescription
browse_marketplaceSearch and filter listings by type, category, chain, rating, with pagination
get_listingFull details for a specific listing by slug
get_featuredFeatured marketplace items
get_top_ratedTop-rated listings
get_agentERC-8004 agent info by network and ID
list_categoriesAll available marketplace categories
list_networksSupported blockchain networks
list_agentsAll registered ERC-8004 agents with pagination

​
Management Tools

Manage your x402Studio resources programmatically. Requires a PAT.
ToolDescriptionScope
list_my_endpointsList all your endpointsmcp:read
list_my_campaignsList all your fundraiser campaignsmcp:read
create_campaignCreate a fundraiser campaign with internal endpoint provisioningmcp:campaigns:write
update_campaignUpdate allowlisted fundraiser campaign fieldsmcp:campaigns:write
get_endpoint_detailsFull endpoint info including credit balancemcp:read
get_endpoint_statsUsage analytics (requests, revenue, success rate)mcp:read
update_endpointUpdate pricing, listing flags, webhook settingsmcp:endpoints:write
delete_endpointPermanently delete an endpointmcp:endpoints:write
list_my_productsList all your productsmcp:read
update_productUpdate metadata, pricing, branding, listing statemcp:products:write
set_webhookSet or update webhook URL (returns signing secret)mcp:endpoints:write
remove_webhookRemove webhook from an endpointmcp:endpoints:write

​
Payment Tools

Complete payment-backed operations through MCP. These tools handle the x402 challenge-response flow.
ToolDescription
request_endpoint_creation_paymentGet the x402 challenge to create a new endpoint
create_endpoint_with_paymentFinalize endpoint creation after payment
request_endpoint_topup_paymentGet the x402 challenge to add credits
topup_endpoint_with_paymentComplete a credit top-up after payment
request_product_purchase_paymentGet the x402 challenge for a product purchase
purchase_product_with_paymentComplete a product purchase after payment
request_endpoint_credit_purchase_paymentGet the x402 challenge for credit pack purchase
purchase_endpoint_credits_with_paymentComplete a credit pack purchase after payment

​
How Payment Flows Work

  1. Request — Call the request_* tool to get an x402 payment challenge
  2. Sign — The AI client’s wallet signs the USDC payment on-chain
  3. Complete — Call the corresponding completion tool with the X-Payment payload
  4. Done — The resource is created, topped up, or purchased

​
Agent Registry Tools

Wallet-session tools for ERC-8004 and Solana-8004 agent management.
ToolDescription
get_agent_registry_infoPublic registry info and supported networks
request_agent_wallet_challengeRequest wallet-auth challenge for registration
verify_agent_wallet_challengeVerify signature, get session token
list_my_agent_bindable_endpointsList endpoints available for agent binding
list_my_registered_agentsList agents owned by authenticated wallet
prepare_agent_registrationPrepare wallet-first registration flow
finalize_agent_registrationFinalize after on-chain transaction
prepare_agent_updatePrepare agent metadata update
finalize_agent_updateFinalize update after any on-chain tx
submit_agent_feedbackSubmit reputation feedback for an agent
MCP never holds wallet private keys. The wallet signs locally, and MCP exchanges the signature for a short-lived session token.

​
MCP Resources

Static resources available via the MCP resource protocol:
URIDescription
singularity://featuredFeatured marketplace listings
singularity://top-ratedTop rated listings
singularity://categoriesAvailable categories
singularity://networksSupported blockchain networks
singularity://agentsAll registered ERC-8004 agents
singularity://listing/{slug}Individual listing details
singularity://agent/{network}/{id}Agent details by network and ID

​
Security

  • Secrets never touch the AI model — PATs and API keys are passed per-request to the MCP server and never stored. They are used only for authentication and immediately discarded after the request completes.
  • No secret logging — Token values are never written to logs, analytics, or any persistent storage on the MCP server.
  • Prompt injection safe — Because secrets are handled at the transport layer (HTTP headers), they cannot be extracted through prompt injection attacks against the AI client.
  • Scoped access — Read-only PATs (mcp:read) cannot perform writes. Endpoint-write PATs cannot mutate products (and vice versa).
  • Instant revocation — Revoked or expired PATs are rejected immediately. Revoke from Dashboard > Settings > PAT at any time.
  • Owner isolation — All tool calls are scoped to the authenticated owner’s resources. You cannot access another user’s data.

​
Server Info

PropertyValue
Endpointhttps://mcp.x402layer.cc/mcp
ProtocolMCP 2024-11-05
TransportHTTP (stateless)
Total Tools35

Full MCP Documentation

See the complete MCP server reference for advanced usage, direct API testing, and detailed parameter schemas.