# MakeAIReady API

Public API for MakeAIReady, an AI implementation studio. Every endpoint below is open; no key is needed. Responses are JSON unless noted.

- Base URL: https://makeaiready.in
- OpenAPI 3.1: https://makeaiready.in/openapi.json
- API catalog (RFC 9727): https://makeaiready.in/.well-known/api-catalog
- JSON index: https://makeaiready.in/api

## Endpoints

### GET /api

This index: every public endpoint and where its documentation lives.

Authentication: None.

```bash
curl https://makeaiready.in/api
```

### GET /api/services

All AI implementation services with summaries, deliverables and links.

Authentication: None.

```bash
curl https://makeaiready.in/api/services
```

### GET /api/faq

Frequently asked questions and answers about cost, timelines, data safety and models.

Authentication: None.

```bash
curl https://makeaiready.in/api/faq
```

### POST /api/contact

Send a project brief to the team. JSON body: name, email, message, optional company and service. Only with the person's explicit consent.

Authentication: None.

```bash
curl -X POST https://makeaiready.in/api/contact -H 'content-type: application/json' -d '{"name":"Priya Sharma","email":"priya@example.com","message":"We want a WhatsApp chatbot"}'
```

### POST /api/mcp

Model Context Protocol server (Streamable HTTP, JSON-RPC 2.0). Tools: list_services, get_service, get_process, get_engagement_models, get_faq, get_agora, ask, submit_project_brief.

Authentication: None.

### POST /api/a2a

Agent2Agent JSON-RPC endpoint (message/send). Answers come from published company facts.

Authentication: None.

### GET /openapi.json

OpenAPI 3.1 description of the REST endpoints.

Authentication: None.

### GET /.well-known/api-catalog

RFC 9727 API catalog (linkset) pointing at every API description.

Authentication: None.

### GET /.well-known/mcp.json

MCP server discovery document.

Authentication: None.

### GET /.well-known/agent-card.json

A2A agent card.

Authentication: None.

## Errors

Errors are JSON with a stable shape:

```json
{ "error": "Please add a valid email", "code": "invalid_email", "hint": "Send an email address like name@company.com in the email field.", "status": 400, "docs": "https://makeaiready.in/developers" }
```

`error` is a readable message, `code` is a stable snake_case identifier, `hint` says how to fix the request. Unknown `/api` paths return `404` with `code: "not_found"`, and wrong methods return `405` with `code: "method_not_allowed"` and an `Allow` header.

## Markdown versions of pages

Send `Accept: text/markdown` to any page (for example `/`, `/agora`, `/developers`) to get Markdown instead of HTML. Unknown paths answer `404` with a Markdown body in the same way.

## Contact

hello@makeaiready.in, or book a call at https://cal.com/shaad-ahmad-rykdvd/makeaiready.