---
title: "Business Registration"
description: "Make your business agent-readable and discoverable in the Intent Marketplace."
canonical: "https://docs.ainative.studio/docs/marketplace/business-registration"
last-updated: "2026-10-26T19:08:16.785Z"
---

# Business Registration

Source: https://docs.ainative.studio/docs/marketplace/business-registration

> Make your business agent-readable and discoverable in the Intent Marketplace.

## 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:

```bash
POST /api/v1/public/marketplace/scan
```

```json
{
  "url": "https://your-api.com",
  "name": "Your Business Name",
  "description": "Optional description"
}
```

**Response:**

```json
{
  "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

### 1. OpenAPI (Recommended)

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`:

```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:

```markdown
## 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:

| Signal | Points |
|--------|--------|
| 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:

```bash
POST /api/v1/cloud/agents/register
```

```json
{
  "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:

```bash
POST /api/v1/public/beckn-network/registry/subscribe
```

```json
{
  "subscriber_id": "your-business.com",
  "subscriber_url": "https://your-api.com/beckn",
  "type": "BPP",
  "domain": "nic2004:52110",
  "country": "US"
}
```

See [Beckn Network](/docs/marketplace/beckn-network) for details.