Singularity Layer MCP

Choose your platform to add the Singularity MCP server. Click to expand setup instructions and config.

What is MCP?

The Model Context Protocol (MCP) is a standardized protocol for connecting AI assistants to external systems. It provides a unified way for AI models to access tools, resources, and prompts from external services.

The Singularity Layer MCP server exposes the broader platform through this protocol, combining marketplace discovery, endpoint and product management, and ERC-8004 agent access in a single MCP surface.

Release & Registry Status

The runtime server name remains singularity-mcp, while the official registry package is io.github.ivaavimusic/singularity.

Endpoint

# MCP HTTP Endpoint
https://mcp.x402layer.cc/mcp

# Alternative Cloudflare Worker URL
https://sgl-mcp.ivaavimusicproductions.workers.dev/mcp

Client Configuration

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "singularity": {
      "url": "https://mcp.x402layer.cc/mcp"
    }
  }
}

Cursor IDE

Add to your Cursor MCP settings (.cursor/mcp.json in your project root):

{
  "mcpServers": {
    "singularity": {
      "url": "https://mcp.x402layer.cc/mcp"
    }
  }
}

Antigravity / Codex CLI

Add to your MCP config (~/.codex/mcp.json or your project .codex/mcp.json):

{
  "mcpServers": {
    "singularity": {
      "url": "https://mcp.x402layer.cc/mcp",
      "transport": "http"
    }
  }
}

Windsurf / Other MCP Clients

Configure the HTTP transport endpoint:

# HTTP Transport URL
https://mcp.x402layer.cc/mcp

# Protocol: HTTP (stateless)
# Transport: Streamable HTTP

Discovery Tools (Phase 1 — No Auth)

Browse and discover marketplace listings, agents, and categories. No authentication required.

PAT Authentication

Personal access tokens are now the default account-level credential for MCP. Create them in Dashboard → Settings → PAT and use accessToken for owner-wide MCP automation. Legacy endpoint keys remain supported for endpoint-scoped flows.

Management Tools (Phase 2 + 2.5 — PAT First)

Manage your x402 endpoints and products through authenticated MCP tools. Use accessToken with a scoped sgl_pat_* token for owner-wide automation. Legacy endpoint keys in the x402_* format remain supported where noted.

Phase 3 Payment Tools

MCP can now request payment challenges and complete endpoint creation, endpoint top-up, public product purchase, and public credit-pack purchase flows. Consumer purchase tools wrap the existing public purchase contracts only and do not act as a generic paid endpoint proxy.

Available Resources

Phase 4 Agent Registry Tools

MCP now exposes the worker wallet-session flows for ERC-8004 and Solana-8004 registration and management. The wallet signs locally, then MCP exchanges that signature for a short-lived session token. MCP does not hold the wallet private key.

Usage Examples

Browse Marketplace

// Tool call: browse_marketplace
{
  "name": "browse_marketplace",
  "arguments": {
    "category": "ai",
    "sort": "rating",
    "limit": 10
  }
}

Get Endpoint Details (Phase 2)

// Tool call: get_endpoint_details
{
    "name": "get_endpoint_details",
  "arguments": {
    "slug": "my-api-endpoint",
    "accessToken": "sgl_pat_your_token_here"
  }
}

Set Webhook (Phase 2)

// Tool call: set_webhook
{
    "name": "set_webhook",
  "arguments": {
    "slug": "my-api-endpoint",
    "webhookUrl": "https://my-server.com/webhook",
    "accessToken": "sgl_pat_your_token_here"
  }
}

// Response includes signing secret (save it!)
{
  "success": true,
  "webhook": {
    "url": "https://my-server.com/webhook",
    "signing_secret": "whsec_abc123...",
    "note": "Save this secret — it will not be shown again"
  }
}

Get ERC-8004 Agent

// Tool call: get_agent (EVM)
{
  "name": "get_agent",
  "arguments": {
    "network": "base",
    "agentId": 1
  }
}

// Tool call: get_agent (Solana)
{
  "name": "get_agent",
  "arguments": {
    "network": "solana",
    "assetAddress": "AssetAddress123..."
  }
}

Direct API Testing

# Test MCP initialize
curl -X POST https://mcp.x402layer.cc/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'

# List all tools (should return 25)
curl -X POST https://mcp.x402layer.cc/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":2}'

# Browse marketplace
curl -X POST https://mcp.x402layer.cc/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"browse_marketplace","arguments":{"limit":5}},"id":3}'

Categories

Supported Networks

Server Metadata

Roadmap

Resources