API for developers and AI agents

Endpoints

• GET/api

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

  curl https://makeaiready.in/api

• GET/api/services

  All AI implementation services with summaries, deliverables and links.

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

• GET/api/faq

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

  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.

  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.

• POST/api/a2a

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

• GET/openapi.json

  OpenAPI 3.1 description of the REST endpoints.

• GET/.well-known/api-catalog

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

• GET/.well-known/mcp.json

  MCP server discovery document.

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

  A2A agent card.

Errors

Errors are JSON with a readable error, a stable code and a hint on how to fix the request. Unknown API paths return 404 and wrong methods return 405 with an Allow header.

{
  "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"
}

Markdown for agents

Send Accept: text/markdown to any page, such as / or /agora, to get Markdown instead of HTML. The site map for language models is /llms.txt.