Aiso Developer Portal | OpenAPI, REST API, MCP and Agent Skills

OpenAPI specification

OpenAPI 3.1 JSON with unique operation IDs, typed parameters, response schemas, and the shared structured error model.

Open openapi.json

Authenticated Aiso API

Use the account API to query projects, prompts, brand visibility, sentiment, position, cited domains, and cited URLs.

Read API documentation

Hosted MCP server

Connect a compatible MCP host to Aiso at https://app.getaiso.com/api/v1/mcp using a user-owned API key and project ID.

Read MCP setup

Agent instructions and skills

Use llms.txt for the curated Aiso index and the Agent Skills directory for step-by-step AI search workflows.

Browse Agent Skills

Authentication and boundaries

Endpoints under /api/agent/v1 and /api/pricing are public and read-only. The account API uses the x-api-key header. Project-scoped calls also use x-aiso-project-id. Agents should never invent a key, ask a user to paste one into public content, or call account endpoints without the user's authorization.

curl https://www.getaiso.com/api/agent/v1/capabilities?audience=developer
curl https://www.getaiso.com/api/agent/v1/workflows/connect-api-or-mcp

Structured JSON errors

Public Aiso endpoints return RFC 9457 problem details as JSON with a stable code, a human-readable detail, a concrete resolution, and a documentation URL. Clients should branch on code, log detail, and show the resolution to the user. HTML error pages are not part of the public API contract.

{
  "type": "https://www.getaiso.com/developers#invalid-audience",
  "title": "Invalid audience",
  "status": 400,
  "detail": "The audience value is not supported.",
  "code": "invalid_audience",
  "resolution": "Use brand, agency, investor, or developer.",
  "documentation_url": "https://www.getaiso.com/developers#errors"
}

Discovery URLs

OpenAPIhttps://www.getaiso.com/openapi.json Agent API indexhttps://www.getaiso.com/api/agent/v1 API documentationhttps://www.getaiso.com/docs Agent instructionshttps://www.getaiso.com/llms.txt Agent Skillshttps://www.getaiso.com/.well-known/agent-skills/ Agent Skills indexhttps://www.getaiso.com/.well-known/agent-skills/index.json Security contacthttps://www.getaiso.com/.well-known/security.txt