# Business Server AI

> MCP-native public directory for AI agents. Businesses, freelancers, jobs, and startups — searchable, quotable, bookable.

Business Server AI is an open, machine-readable directory built for autonomous AI agents.
Agents (Claude, GPT, Grok, Perplexity, Gemini, Cursor, etc.) connect via MCP to search,
get quotes, create reviews, and book services in real time.

Currently listing 10 approved listings.

## Listing Types

- **Businesses** (0) — local businesses: plumbers, salons, restaurants, repair shops, clinics, etc.
- **Freelancers** (10) — independent professionals: designers, developers, copywriters, consultants, etc.
- **Jobs** (0) — job openings and candidate matching: full-time, part-time, contract, remote positions.
- **Startups** (0) — early-stage companies seeking investment, buyers, partners, or co-founders.

## How to connect your agent

MCP endpoint (Streamable HTTP):
```
POST http://aibusinessserver.railway.internal:8080/mcp
Content-Type: application/json
```

### MCP Tools

#### search_listings
Search for businesses, freelancers, jobs, or startups. Returns approved listings matching the query.

Parameters:
- `query` (string, required) — search query
- `type` (string, optional) — filter: "business", "freelancer", "job", or "startup"
- `category` (string, optional) — category slug
- `city` (string, optional) — city name or slug
- `limit` (number, optional) — max results, default 10

Example queries:
- "Find a plumber in Chicago"
- "Find a React developer freelancer"
- "Find remote jobs for designers"
- "Find AI startups seeking seed funding"
- "Hair salon near me" (with city parameter)

#### get_listing_details
Get full details of a listing by ID or by country/city/slug. Includes approved reviews.

Parameters:
- `listingId` (string, optional) — MongoDB ObjectId
- `country` (string, optional) — country code
- `city` (string, optional) — city slug
- `slug` (string, optional) — listing slug

#### create_review
Create an anonymous review for a listing. Submitted for moderation.

Parameters:
- `listingId` (string, required) — listing to review
- `rating` (number, required) — 1 to 5
- `comment` (string, required) — review text, 10-1000 chars

Rate limit: 5 reviews per hour per IP.

#### request_quote
Request a price quote from a business.

Parameters:
- `businessId` (string, required) — business to quote
- `serviceDescription` (string, required) — what you need

#### create_booking
Book a service directly.

Parameters:
- `businessId` (string, required)
- `serviceDescription` (string, required)
- `requestedAt` (string, required) — ISO 8601 date
- `contactName`, `contactPhone` (required), `contactEmail`, `notes` (optional)

### Legacy tools (backward-compatible)

- `search_business` — search legacy businesses by query, country, city
- `get_business_details` — full info by ID or country/city/slug

## Alternative access

- Every listing page supports `?format=md` for plain Markdown output
- Schema.org JSON-LD on every page
- RSS feed: https://business-server.ai/feed.xml
- Full directory: https://business-server.ai/llms-full.txt

## Key pages

- [Home](https://business-server.ai/)
- [All Businesses](https://business-server.ai/listings/businesses)
- [All Freelancers](https://business-server.ai/listings/freelancers)
- [All Jobs](https://business-server.ai/listings/jobs)
- [All Startups](https://business-server.ai/listings/startups)
- [Add a listing](https://business-server.ai/add)
- [Full directory](https://business-server.ai/llms-full.txt) — every listing with full details
- [RSS](https://business-server.ai/feed.xml) — latest listings
- [Sitemap](https://business-server.ai/sitemap.xml)