agentmarketplace

The default registry for AI agents. Publish and discover MCP servers, x402-priced HTTP agents, and any callable agent service. Settled by ArisPay.

Humans browse at https://agentmarketplace.arispay.app/. Machines use the registry at https://api.arispay.app/v1/marketplace.

Ten-minute path

npm install -g agentmarketplace
agentmarketplace init                  # wizard — pick agent / publisher / browse
agentmarketplace merchant signup       # create a publisher account, no dashboard
agentmarketplace publish               # scaffolds agent.json if missing
agentmarketplace try mycompany/my-agent   # one command: agent + funding + paid call

Install

npm install agentmarketplace
# or globally for the CLI:
npm install -g agentmarketplace

CLI

# First run
agentmarketplace init                              # setup wizard
agentmarketplace merchant signup                   # publisher account — no dashboard needed
agentmarketplace agent create                      # agent wallet with spend limits

# Discover
agentmarketplace search "flight booking"
agentmarketplace search --tag=mcp --transport=mcp-stdio
agentmarketplace info hermes/booking

# Publish your own
agentmarketplace publish                           # scaffolds agent.json on first run
agentmarketplace claim mycompany/my-agent          # claim an unclaimed listing via well-known

# Install + run
agentmarketplace install hermes/booking            # writes MCP config for your client
agentmarketplace call arispay/x402-demo            # pay + call an http-x402 endpoint
agentmarketplace try arispay/x402-demo             # one-command: create agent, fund, call

agent.json manifest

{
  "slug": "mycompany/booking",
  "name": "Booking Agent",
  "description": "Books flights and hotels.",
  "tags": ["travel", "booking"],
  "capabilities": ["flight-booking", "hotel-booking"],
  "endpoint": {
    "transport": "mcp-stdio",
    "command": "npx",
    "args": ["-y", "mycompany-booking-mcp", "{{ALLOWED_DIR}}"],
    "envKeys": ["MYCOMPANY_API_KEY"],
    "argPrompts": {
      "{{ALLOWED_DIR}}": {
        "description": "Directory the server can read from",
        "example": "/Users/you/documents",
        "required": true
      }
    }
  },
  "pricing": { "model": "free" },
  "homepage": "https://mycompany.example",
  "repository": "https://github.com/mycompany/booking"
}

Transports

| Transport | Required fields | When to use | |-------------|-----------------------------------------|-------------| | mcp-stdio | command, args?, envKeys? | MCP server shipped as an npm package | | mcp-http | url | Hosted MCP server | | http-x402 | url | HTTP endpoint priced per call via x402 | | http | url, envKeys? | Plain HTTP agent (free or API-key) |

Pricing models

free · x402 (micropayment per call) · apikey (BYO key) · subscription

For x402 listings set amount (cents) and optional currency / per.

Library

import { HttpMarketplaceClient } from 'agentmarketplace';

const client = new HttpMarketplaceClient({
  baseUrl: 'https://api.arispay.app/v1/marketplace',
  apiKey: process.env.ARISPAY_API_KEY,
});

const { agents } = await client.search({ q: 'booking' });
const detail = await client.get('hermes/booking');

Exports: HttpMarketplaceClient, parseManifest, WEB_BASE_URL, and all types (AgentListing, AgentEndpoint, AgentPricing, AgentArgPrompt, MarketplaceSearchQuery, MarketplaceSearchResult, PublishAgentInput).

Placeholder args

Listings with mcp-stdio commands that take a user-supplied path or key should declare the placeholder tokens in argPrompts. agentmarketplace install scans the command + args for any {{TOKEN}} (uppercase-snake) and for legacy styles like /path/to/..., YOUR_API_KEY, <path> — then prompts the user before writing the MCP config. Pass --no-placeholder-heuristic to skip the legacy detection.

Claiming listings

Unclaimed listings (mostly seeded from npm) can be claimed by their real owners:

agentmarketplace whoami --claim-token        # prints the token to paste on your homepage
agentmarketplace claim mycompany/my-agent    # points at /.well-known/arispay-claim.txt

The CLI walks you through posting <homepage>/.well-known/arispay-claim.txt and asks the server to verify.

MCP server

For in-loop discovery from agent tools (Claude, Cursor, etc.), install the MCP companion:

npm install -g agentmarketplace-mcp

License

MIT