---
title: "Docs: Connect to the Aakaar AI MCP Server | Aakaar AI"
description: "Connect Claude, ChatGPT or any agent to the Aakaar AI MCP server: OAuth sign-in, endpoints, the OpenAPI description and the machine-readable files for agents."
canonical: "https://www.aakaarai.com/docs"
---
# Docs: Connect to the Aakaar AI MCP Server | Aakaar AI

URL: https://www.aakaarai.com/docs

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 Authenticate Reference For agents

## Connect

One hosted URL. It works in Claude and ChatGPT, and in any client that supports remote MCP servers.

⌘ mcp.aakaarai.com/mcp Copy

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

#### OpenAPI description

OpenAPI 3.1 for the OAuth and MCP endpoints, including the read and write scopes.

openapi.json

MCP

#### MCP server card

Machine-readable summary of the server and its remote endpoint.

server-card.json

SITE GUIDE

#### llms.txt

What Aakaar AI is, when to use it, pricing and where everything lives. Full site text is in llms-full.txt.

llms.txt

SITEMAP

#### Sitemap

Every public page, with last-modified dates.

sitemap.xml

## For agents

Open standards that let an AI agent or a discovery service find what Aakaar offers without scraping pages.

DISCOVERY

#### Resource catalog (ARD)

A catalog of the agentic resources Aakaar publishes, so discovery services can find the MCP server and the API description.

ard.json

SKILLS

#### Agent skill

A ready-made skill that teaches an agent how to connect to the Aakaar MCP server and use it safely.

agent-skills/index.json

In 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.

Book a demo See the MCP page