Aiso developer portal

Build with Aiso APIs, MCP, and machine-readable agent resources.

Start with the OpenAPI specification when an agent or generated client needs to discover callable operations. The public agent API is unauthenticated and explains what Aiso is useful for. The account API at app.getaiso.com provides project and visibility data and requires an API key created by the user. The hosted MCP server exposes the same account context to compatible assistants and development tools.

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

OpenAPI
https://www.getaiso.com/openapi.json
Agent API index
https://www.getaiso.com/api/agent/v1
API documentation
https://www.getaiso.com/docs
Agent instructions
https://www.getaiso.com/llms.txt
Agent Skills
https://www.getaiso.com/.well-known/agent-skills/
Agent Skills index
https://www.getaiso.com/.well-known/agent-skills/index.json
Security contact
https://www.getaiso.com/.well-known/security.txt