Docs
Build with Aakaar AI.
Connect an AI agent to the Aakaar MCP server, see how sign-in works, and find the machine-readable descriptions of this site.
Connect
One hosted URL. It works in Claude and ChatGPT, and in any client that supports remote MCP servers.
- 01
Add a custom connector
In Claude or ChatGPT, open Settings → Connectors and add a custom MCP connector. Paste the server URL.
- 02
Sign in with OAuth
Approve the sign-in in your browser. There are no API keys to create or store.
- 03
Ask about your account
The Aakaar tools appear in your client. Reads run directly; changes to campaigns, bids, budgets and listings wait for your approval.
Prefer to watch it? See the setup walkthrough.
Authenticate
Sign-in is standard OAuth. If you are building a client, these are the endpoints on https://mcp.aakaarai.com.
- Flow
- OAuth 2.1 authorization code with PKCE (S256)
- Client type
- Public client, no client secret
- Registration
- Optional dynamic client registration; any client id is accepted at sign-in
- Scopes
- read (used when none is requested) and write
- Token lifetime
- 30 days by default
- Transport
- MCP Streamable HTTP over HTTPS
| Method | Path | Purpose |
|---|---|---|
| GET | /.well-known/oauth-protected-resource | Protected resource metadata |
| GET | /.well-known/oauth-authorization-server | Authorization server metadata |
| POST | /mcp/register | Register a client (optional) |
| GET | /mcp/authorize | Start sign-in: redirects the browser |
| POST | /mcp/token | Exchange the authorization code for an access token |
| POST | /mcp | Send MCP messages. Needs a Bearer access token |
Request and response details for each endpoint are in the OpenAPI description.
Reference
Files for developers and tools to read.
OpenAPI description
OpenAPI 3.1 for the OAuth and MCP endpoints, including the read and write scopes.
openapi.jsonllms.txt
What Aakaar AI is, when to use it, pricing and where everything lives. Full site text is in llms-full.txt.
llms.txtFor agents
Open standards that let an AI agent or a discovery service find what Aakaar offers without scraping pages.
Resource catalog (ARD)
A catalog of the agentic resources Aakaar publishes, so discovery services can find the MCP server and the API description.
ard.jsonAgent skill
A ready-made skill that teaches an agent how to connect to the Aakaar MCP server and use it safely.
agent-skills/index.jsonIn browsers that support WebMCP, this site also offers three read-only tools to in-page agents: get_aakaar_overview, get_mcp_connection_info and find_aakaar_page.
Need a hand connecting?
Our team will walk you through setup on your own account.