# Singularity Layer MCP

> Singularity Layer MCP is an MCP server for finance and payments. Browse x402 marketplace listings, manage endpoints and run payment flows from an agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Website:** https://studio.x402layer.cc/docs/agentic-access/mcp-server
- **MCP Registry name:** io.github.ivaavimusic/singularity
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The server is the MCP front end for Singularity Layer, a marketplace and payment layer built around the x402 payment protocol. Discovery tools need no authentication: browse and filter listings, fetch featured or top-rated items, list categories and supported blockchain networks, and look up registered ERC-8004 agents. Management tools use personal access tokens with scopes for reading inventory, writing endpoints, campaigns or products, so a read-only token cannot change anything.

Payment tools let an agent request an x402 challenge, pay it from its own wallet, and complete creating an endpoint, topping up credits or buying a product. A registry group handles agent registration and updates with wallet signatures. The server never holds a wallet private key; the wallet signs locally and the server swaps the signature for a short-lived session token. On-chain steps still need gas from that wallet.

The docs list version 1.6.0, dated March 22, 2026. Tokens and keys are passed per request and not stored. A stateless Streamable HTTP endpoint is provided, with an alternative Cloudflare Worker URL.

## Features

- **Marketplace discovery:** Browse, filter and rate-sort listings without auth.
- **Scoped access tokens:** Separate read and write scopes limit what a token can change.
- **x402 payment flows:** Request a payment challenge and complete purchases.
- **Agent registry:** Register and update agents with wallet signatures.
- **Webhook management:** Set or remove endpoint webhooks.
- **No private keys held:** Wallets sign locally.

## Good for

- Browse paid API endpoints and agents on a marketplace
- Top up credits on an endpoint using an agent's wallet
- Create a fundraiser campaign endpoint
- Register an ERC-8004 agent from a wallet session
- Update product pricing and listing state

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http singularity https://mcp.x402layer.cc/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.x402layer.cc/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "singularity": {
      "type": "http",
      "url": "https://mcp.x402layer.cc/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "singularity": {
      "serverUrl": "https://mcp.x402layer.cc/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "singularity": {
      "type": "http",
      "url": "https://mcp.x402layer.cc/mcp"
    }
  }
}
```

## Tools

- `browse_marketplace`: Search and filter listings with pagination
- `get_listing`: Detailed info for one listing
- `get_featured`: Featured marketplace items
- `get_top_rated`: Top-rated listings
- `get_agent`: ERC-8004 agent information
- `list_categories`: List all categories
- `list_networks`: List supported blockchain networks
- `list_agents`: List registered ERC-8004 agents
- `get_endpoint_details`: Full endpoint info including credit balance
- `get_endpoint_stats`: Usage analytics for an endpoint
- `list_my_endpoints`: List endpoints in owner scope
- `list_my_campaigns`: List fundraiser campaigns
- `create_campaign`: Create a fundraiser campaign
- `update_campaign`: Update campaign metadata
- `update_endpoint`: Update endpoint fields, pricing and webhook settings
- `list_my_products`: List products in owner scope
- `update_product`: Update product metadata, pricing and listing state
- `set_webhook`: Set or update a webhook URL
- `remove_webhook`: Remove a webhook from an endpoint
- `delete_endpoint`: Permanently delete an endpoint
- `request_endpoint_creation_payment`: Request the x402 challenge to create an endpoint
- `create_endpoint_with_payment`: Create an endpoint after payment
- `request_endpoint_topup_payment`: Request the x402 challenge for a top-up
- `topup_endpoint_with_payment`: Complete an endpoint top-up
- `request_product_purchase_payment`: Request the x402 challenge for a product purchase
- `purchase_product_with_payment`: Complete a product purchase
- `request_endpoint_credit_purchase_payment`: Request the x402 challenge for a credit pack
- `purchase_endpoint_credits_with_payment`: Complete a credit-pack purchase
- `get_agent_registry_info`: Public registry info and supported networks
- `request_agent_wallet_challenge`: Request a wallet-auth challenge
- `verify_agent_wallet_challenge`: Verify a signed challenge and get a session token
- `list_my_agent_bindable_endpoints`: List endpoints an agent can bind to
- `list_my_registered_agents`: List agents owned by the wallet
- `prepare_agent_registration`: Prepare a wallet-first registration
- `finalize_agent_registration`: Finalize registration after the on-chain transaction
- `prepare_agent_update`: Prepare an agent update
- `finalize_agent_update`: Finalize an agent update
- `submit_agent_feedback`: Submit reputation feedback

## FAQ

### Do I need authentication?

Not for discovery tools. Management tools use personal access tokens or endpoint keys.

### Does the server hold my wallet key?

No. The wallet signs locally and the server exchanges the signature for a short-lived session token.

### What are the token scopes?

mcp:read, mcp:endpoints:write, mcp:campaigns:write, mcp:products:write and mcp:* for full access.

### Which transport is used?

Stateless Streamable HTTP at https://mcp.x402layer.cc/mcp.

### How do I add Singularity Layer MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http singularity https://mcp.x402layer.cc/mcp

### What are the best alternatives to Singularity Layer MCP?

The closest alternatives to Singularity Layer MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/singularity-layer-mcp
