Skip to main content

Business Registration

Register your business to receive intent-matched requests from AI agents. The marketplace auto-discovers your capabilities from standard protocols.

Auto-Discovery Scan​

The fastest way to register — provide your URL and we scan for agent-readable protocols:

POST /api/v1/public/marketplace/scan
{
  "url": "https://your-api.com",
  "name": "Your Business Name",
  "description": "Optional description"
}

Response:

{
  "url": "https://your-api.com",
  "name": "Your Business Name",
  "capabilities": [
    {"source": "openapi", "name": "POST /orders", "description": "Create a new order"},
    {"source": "ai-plugin", "name": "your-service", "description": "Full service description"}
  ],
  "protocols_found": ["openapi", "ai-plugin"],
  "readiness_score": 85.0,
  "agent_id": "biz-a1b2c3d4e5f6",
  "message": "Found 21 capabilities via openapi, ai-plugin. Readiness: 85.0/100. Registered as agent biz-a1b2c3d4e5f6."
}

Supported Protocols​

Expose an OpenAPI 3.x spec at one of these paths:

  • /openapi.json
  • /api/openapi.json
  • /swagger.json

The scanner extracts all endpoints as capabilities.

2. AI Plugin Manifest​

Host a file at /.well-known/ai-plugin.json:

{
  "schema_version": "v1",
  "name_for_human": "Your Business",
  "name_for_model": "your_business",
  "description_for_human": "What your business does",
  "description_for_model": "Detailed description for AI agents",
  "api": {
    "type": "openapi",
    "url": "https://your-api.com/openapi.json"
  }
}

3. agent.md​

Place a markdown file at /agent.md describing what your business offers in agent-readable format:

# Your Business Agent Profile

## Capabilities
- Sustainable packaging materials
- Bulk orders (1000+ units)
- ISO 14001 certified
- US-based fulfillment

## Pricing
- Standard: $2.50/unit
- Bulk (1000+): $1.80/unit

## Contact
- API: https://your-api.com/v1
- Email: api@your-business.com

4. HTML Meta Tags (Fallback)​

If no other protocol is found, the scanner extracts your <meta name="description"> tag.

Readiness Score​

Your readiness score (0-100) determines how prominently you appear in search results:

SignalPoints
Has OpenAPI spec+25
Has AI Plugin Manifest+25
Has agent.md+15
Number of capabilities (up to 10)+2 each
Callable API endpoints+15

Tip: Having both OpenAPI and AI Plugin Manifest gives you 50 points immediately.

Manual Registration​

If you prefer to register manually via the Agent Cloud Registry:

POST /api/v1/cloud/agents/register
{
  "agent_type": "business",
  "capabilities": ["sustainable-packaging", "bulk-orders", "iso-14001"],
  "endpoint_url": "https://your-api.com/beckn",
  "is_public": true,
  "description": "Eco-friendly packaging supplier with ISO 14001 certification",
  "protocols": ["openapi", "beckn"]
}

Beckn Network Registration​

To participate in the Beckn commerce network, also register as a BPP:

POST /api/v1/public/beckn-network/registry/subscribe
{
  "subscriber_id": "your-business.com",
  "subscriber_url": "https://your-api.com/beckn",
  "type": "BPP",
  "domain": "nic2004:52110",
  "country": "US"
}

See Beckn Network for details.