io.github.ivaavimusic/singularity

Official38 tools

Singularity Layer MCP

MCP for Singularity Layer - discover listings, manage assets, run payment flows, and use agents

Access Singularity Layer listings, manage digital assets, and execute payment workflows.

Captured live from the server via tools/list.

browse_marketplace

Browse and search the Singularity Marketplace with various filters. Returns listings of endpoints, products, and agentic services.

Parameters (12)

typestring
Type of listing to filter by
categorystring
Category to filter by
chainstring
Blockchain network to filter by
modestring
Payment mode filter
searchstring
Search term to find matching listings
sortstring
Sort order
minRatingnumber
Minimum average rating (0-5)
minPricenumber
Minimum price filter
maxPricenumber
Maximum price filter
limitnumber
Maximum number of results (default: 20)
offsetnumber
Pagination offset (default: 0)
featuredboolean
Only return featured listings

get_listing

Get detailed information about a specific marketplace listing by its slug.

Parameters (1)

slugstringrequired
The unique slug identifier for the listing

get_featured

Get featured marketplace listings (endpoints and products highlighted by the platform).

Parameters (1)

limitnumber
Maximum number of featured items to return (default: 12)

get_top_rated

Get top-rated marketplace listings sorted by average rating.

Parameters (1)

limitnumber
Maximum number of top-rated items to return (default: 12)

get_agent

Get details for a specific ERC-8004 or Solana-8004 agent by network and identifier.

Parameters (3)

networkstringrequired
The blockchain network (base, ethereum, polygon, bsc, monad, solana)
agentIdnumber
The numeric agent ID (for EVM chains)
assetAddressstring
The asset address (for Solana)

list_categories

List all available marketplace categories.

No parameters.

list_networks

List all supported blockchain networks.

No parameters.

list_agents

List all registered ERC-8004 and Solana-8004 agents.

Parameters (3)

networkstring
Filter by network
limitnumber
Maximum results (default: 50)
offsetnumber
Pagination offset (default: 0)

list_my_endpoints

List the endpoints accessible to the dashboard owner behind your MCP access token or endpoint API key. PATs are preferred for owner-wide inventory and require mcp:read or mcp:*.

Parameters (2)

accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)

list_my_campaigns

List fundraiser campaigns owned by the dashboard user behind your MCP personal access token. Requires mcp:read or mcp:*.

Parameters (2)

accessTokenstringrequired
Your dashboard MCP personal access token (sgl_pat_*)
slugstring
Optional campaign slug to fetch a single owned campaign

create_campaign

Create a fundraiser campaign owned by the dashboard user behind your MCP personal access token. Requires mcp:campaigns:write or mcp:*.

Parameters (17)

accessTokenstringrequired
Your dashboard MCP personal access token (sgl_pat_*)
titlestringrequired
Campaign title
targetAmountnumberrequired
Funding target in USDC
walletAddressstringrequired
Solana payout wallet for creator disbursal
descriptionstring
Campaign description
xHandlestring
Optional X handle without @
imagesarray
Up to 5 HTTPS image URLs
linksany
Optional campaign links array
tokenTickerstring
2-10 uppercase alphanumeric ticker
feeOptionstring
Fee share option
feeSplitPctnumber
Creator split percentage when feeOption=split
deadlinestring
ISO datetime deadline
categorystring
Category label
subcategorystring
Subcategory label
bagsConfigTypestring
Optional Bags fee tier config UUID
idempotencyKeystring
Optional idempotency key for safe retries
clientReferenceIdstring
Optional client reference alias for idempotency

update_campaign

Update allowlisted fundraiser campaign fields such as title, description, x handle, images, and links. Requires mcp:campaigns:write or mcp:*.

Parameters (7)

accessTokenstringrequired
Your dashboard MCP personal access token (sgl_pat_*)
slugstringrequired
Campaign slug to update
titlestring
Updated campaign title
descriptionstring
Updated campaign description
xHandlestring
Updated X handle without @
imagesarray
Updated HTTPS image URLs
linksany
Updated campaign links array

update_endpoint

Update allowlisted endpoint fields such as metadata, pricing, listing flags, imagery, wallet, payment options, slug, and webhook settings. PATs are preferred and require mcp:endpoints:write or mcp:*.

Parameters (23)

slugstringrequired
The existing slug of the endpoint you want to update
accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)
namestring
Updated endpoint name
descriptionstring
Updated description
categorystring
Updated category
originUrlstring
Updated origin URL
modestring
Pricing mode
pricenumber
Updated endpoint price
currencystring
Updated currency code
activeboolean
Enable or disable the endpoint
walletAddressstring
Updated payout wallet address
chainstring
Updated chain/network
paymentOptionsany
Updated payment options object
imageUrlstring
Updated image URL
logoUrlstring
Updated logo URL
bannerUrlstring
Updated banner URL
creditPackageSizenumber
Credits per package
creditPackagePricenumber
Package price in USDC
newSlugstring
New slug to assign to the endpoint
isListedboolean
Whether the endpoint should be listed
listedInMarketplaceboolean
Whether the endpoint should appear in marketplace listings
webhookUrlstring | null
Set an HTTPS webhook URL or null to remove it

list_my_products

List the products owned by the same dashboard user as your MCP access token or endpoint API key. PATs are preferred and require mcp:read or mcp:*.

Parameters (2)

accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)

update_product

Update allowlisted product fields including metadata, pricing, listing state, payment options, wallet, branding, and slug. PATs are preferred and require mcp:products:write or mcp:*.

Parameters (23)

idstring
Product ID to update
slugstring
Product slug to update
accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)
namestring
Updated product name
descriptionstring
Updated product description
categorystring
Updated product category
pricenumber
Updated product price
currencystring
Updated currency code
activeboolean
Enable or disable the product
chainstring
Updated chain/network
walletAddressstring
Updated payout wallet address
paymentOptionsany
Updated payment options object
isListedboolean
Whether the product should be listed
logoUrlstring
Updated logo URL
bannerUrlstring
Updated banner URL
productImageUrlstring
Updated product image URL
customButtonBgstring
Custom button background color
customButtonTextstring
Custom button text color
customPageBgstring
Custom page background color
customPageTextstring
Custom page text color
customFontstring
Custom font family
newSlugstring
New slug to assign to the product

get_endpoint_details

Get full details for an endpoint you own, including credit balance, pricing config, and wallet address. PATs are preferred and require mcp:read or mcp:*.

Parameters (3)

slugstringrequired
The unique slug identifier for the endpoint
accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)

get_endpoint_stats

Get usage analytics for an endpoint: total requests, monthly requests, revenue, and success rate. PATs or endpoint API keys improve accuracy. PATs require mcp:read or mcp:*.

Parameters (3)

slugstringrequired
The unique slug identifier for the endpoint
accessTokenstring
Your dashboard MCP personal access token (optional)
apiKeystring
Legacy endpoint API key (optional, improves accuracy)

set_webhook

Set or update the webhook URL for an endpoint. Returns a signing secret that must be saved. PATs are preferred and require mcp:endpoints:write or mcp:*.

Parameters (4)

slugstringrequired
The unique slug identifier for the endpoint
webhookUrlstringrequired
HTTPS URL to receive webhook events
accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)

remove_webhook

Remove the webhook URL from an endpoint. PATs are preferred and require mcp:endpoints:write or mcp:*.

Parameters (3)

slugstringrequired
The unique slug identifier for the endpoint
accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)

delete_endpoint

⚠️ DESTRUCTIVE: Permanently delete an endpoint. Cannot be undone. Only works for agent-created endpoints. PATs are preferred and require mcp:endpoints:write or mcp:*.

Parameters (4)

slugstringrequired
The unique slug identifier for the endpoint to delete
accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)
confirmbooleanrequired
Must be true to confirm deletion

request_endpoint_creation_payment

Return the x402 payment challenge needed to create a new agent endpoint. Requires a dashboard PAT with mcp:endpoints:write or mcp:*.

Parameters (17)

accessTokenstringrequired
Your dashboard MCP personal access token (sgl_pat_*)
slugstringrequired
Unique slug for the new endpoint
namestringrequired
Human-readable endpoint name
originUrlstringrequired
Origin URL of the endpoint backend
walletAddressstringrequired
Primary payout wallet address
chainstringrequired
Primary payout network, usually base, solana, or both
descriptionstring
Endpoint description
categorystring
Marketplace category
imageUrlstring
Endpoint image URL
bannerUrlstring
Endpoint banner URL
modestring
Pricing mode
pricenumber
Price per request or base package price
currencystring
Payout currency, default USDC
listOnMarketplaceboolean
Whether to list the endpoint publicly
purchaseAmountnumber
USDC amount to pay on creation, minimum 5
webhookUrlstring | null
Optional HTTPS webhook URL
walletAddressSecondarystring
Secondary wallet when chain is both

create_endpoint_with_payment

Create a new agent endpoint after you have obtained a valid X-Payment payload for the creation challenge. Requires a dashboard PAT with mcp:endpoints:write or mcp:*.

Parameters (18)

accessTokenstringrequired
Your dashboard MCP personal access token (sgl_pat_*)
slugstringrequired
Unique slug for the new endpoint
namestringrequired
Human-readable endpoint name
originUrlstringrequired
Origin URL of the endpoint backend
walletAddressstringrequired
Primary payout wallet address
chainstringrequired
Primary payout network, usually base, solana, or both
paymentPayloadanyrequired
Raw X-Payment payload returned by the paying client, as JSON or base64 string
descriptionstring
Endpoint description
categorystring
Marketplace category
imageUrlstring
Endpoint image URL
bannerUrlstring
Endpoint banner URL
modestring
Pricing mode
pricenumber
Price per request or base package price
currencystring
Payout currency, default USDC
listOnMarketplaceboolean
Whether to list the endpoint publicly
purchaseAmountnumber
USDC amount to pay on creation, minimum 5
webhookUrlstring | null
Optional HTTPS webhook URL
walletAddressSecondarystring
Secondary wallet when chain is both

request_endpoint_topup_payment

Return the x402 payment challenge needed to top up credits for an existing agent endpoint. Accepts either a dashboard PAT with mcp:endpoints:write or mcp:* or a legacy endpoint API key.

Parameters (4)

slugstringrequired
Slug of the endpoint to top up
topupAmountnumberrequired
USDC amount to add, minimum 1
accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)

topup_endpoint_with_payment

Complete an endpoint credit top-up after you have obtained a valid X-Payment payload. Accepts either a dashboard PAT with mcp:endpoints:write or mcp:* or a legacy endpoint API key.

Parameters (5)

slugstringrequired
Slug of the endpoint to top up
topupAmountnumberrequired
USDC amount to add, minimum 1
paymentPayloadanyrequired
Raw X-Payment payload returned by the paying client, as JSON or base64 string
accessTokenstring
Your dashboard MCP personal access token (sgl_pat_*)
apiKeystring
Legacy endpoint API key (x402_*)

request_product_purchase_payment

Return the x402 payment challenge for purchasing a public product. This wraps the existing public /p/:id-or-slug flow and does not require owner credentials.

Parameters (3)

productIdOrSlugstringrequired
Product slug or product ID used in the public /p/:id-or-slug purchase route
clientReferenceIdstring
Optional client reference ID forwarded to the purchase flow
metadataobject
Optional metadata object forwarded to the purchase flow

purchase_product_with_payment

Complete a public product purchase after you have obtained a valid X-Payment payload for that product challenge.

Parameters (4)

productIdOrSlugstringrequired
Product slug or product ID used in the public /p/:id-or-slug purchase route
paymentPayloadanyrequired
Raw X-Payment payload returned by the paying client, as JSON or base64 string
clientReferenceIdstring
Optional client reference ID forwarded to the purchase flow
metadataobject
Optional metadata object forwarded to the purchase flow

request_endpoint_credit_purchase_payment

Return the x402 payment challenge for purchasing a public credit pack from an endpoint that exposes /e/:slug?action=purchase.

Parameters (4)

slugstringrequired
Endpoint slug for the credit-enabled endpoint
walletAddressstring
Optional wallet address to receive the purchased credits when the underlying endpoint supports it
clientReferenceIdstring
Optional client reference ID forwarded to the purchase flow
metadataobject
Optional metadata object forwarded to the purchase flow

purchase_endpoint_credits_with_payment

Complete a public endpoint credit-pack purchase after you have obtained a valid X-Payment payload for the purchase challenge.

Parameters (5)

slugstringrequired
Endpoint slug for the credit-enabled endpoint
paymentPayloadanyrequired
Raw X-Payment payload returned by the paying client, as JSON or base64 string
walletAddressstring
Optional wallet address to receive the purchased credits when the underlying endpoint supports it
clientReferenceIdstring
Optional client reference ID forwarded to the purchase flow
metadataobject
Optional metadata object forwarded to the purchase flow

get_agent_registry_info

Get public ERC-8004 / Solana-8004 registry information, supported networks, worker routes, and wallet-first notes.

No parameters.

request_agent_wallet_challenge

Create a wallet-auth challenge for ERC-8004 agent registration or management. The wallet owner must sign the returned message locally; MCP does not sign with the wallet.

Parameters (4)

chainstringrequired
Wallet auth chain
walletAddressstringrequired
Wallet address that will sign the challenge
actionstring
Session scope to request
payloadobject
Optional payload object to bind into the signed challenge

verify_agent_wallet_challenge

Verify a wallet-signed auth challenge and receive a short-lived session token for agent registry flows.

Parameters (7)

chainstringrequired
Wallet auth chain
walletAddressstringrequired
Wallet address that signed the challenge
noncestringrequired
Nonce returned by request_agent_wallet_challenge
signaturestringrequired
Wallet signature over the challenge message
actionstring
Session scope originally requested
signatureEncodingstring
hex for EVM, base64 for Solana
payloadobject
Optional payload object that was part of the original challenge

list_my_agent_bindable_endpoints

List platform endpoints owned by the authenticated wallet or linked dashboard user that can be bound to ERC-8004 agents.

Parameters (2)

sessionTokenstringrequired
Wallet session token returned by verify_agent_wallet_challenge
listedOnlyboolean
Return only active/listed endpoints

list_my_registered_agents

List ERC-8004 or Solana-8004 agents owned by the authenticated wallet or linked dashboard user.

Parameters (2)

sessionTokenstringrequired
Wallet session token returned by verify_agent_wallet_challenge
networkstring
Optional network filter

prepare_agent_registration

Prepare a wallet-first ERC-8004 or Solana-8004 registration. The caller must later send the on-chain transaction from the same wallet and then call finalize_agent_registration.

Parameters (12)

sessionTokenstringrequired
Wallet session token with erc8004_register scope
namestringrequired
Agent name
descriptionstringrequired
Agent description
networkstringrequired
Target network for the agent
endpointstring
Primary or fallback endpoint URL
imagestring
Agent image URL
ownerAddressstring
Owner wallet address matching the authenticated session wallet
assetAddressstring
Required for Solana registrations
endpointIdsarray
Platform endpoint UUIDs to bind
customEndpointsarray
Custom endpoint URLs to bind
versionstring
Agent version string
tagsarray
Agent tags

finalize_agent_registration

Finalize a wallet-first agent registration after the on-chain transaction has been sent from the same wallet.

Parameters (2)

sessionTokenstringrequired
Wallet session token with erc8004_register scope
payloadobjectrequired
Raw finalize payload expected by the worker, including network, stage, and transaction hash/signature fields

prepare_agent_update

Prepare a wallet-first update for an existing ERC-8004 or Solana-8004 agent. If metadata changes require an on-chain URI update, the response describes that action.

Parameters (2)

sessionTokenstringrequired
Wallet session token with erc8004_manage, erc8004_update, or erc8004_register scope
payloadobjectrequired
Raw update payload expected by the worker, including network plus agentId or assetAddress and the requested fields to change

finalize_agent_update

Finalize a wallet-first update for an existing ERC-8004 or Solana-8004 agent after any required on-chain transaction has been sent from the same wallet.

Parameters (2)

sessionTokenstringrequired
Wallet session token with erc8004_manage, erc8004_update, or erc8004_register scope
payloadobjectrequired
Raw finalize payload expected by the worker, including network plus agentId or assetAddress and any txHash/txSignature/tokenUri fields

submit_agent_feedback

Submit on-chain ERC-8004 or Solana-8004 reputation feedback through the worker feedback route. This requires the separate worker feedback API key, not a wallet session token.

Parameters (9)

apiKeystringrequired
Worker feedback API key
networkstringrequired
Target network for the feedback
ratingnumberrequired
Rating from 1 to 5
agentIdnumber
EVM agent id
assetAddressstring
Solana asset address
commentstring
Optional feedback comment
tag1string
Primary tag, default overall
tag2string
Secondary tag, default agentic
endpointstring
Optional endpoint context string

Install

claude_desktop_config.json

{
  "mcpServers": {
    "singularity": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.x402layer.cc/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.