Developers & agents

Build on Ariso.

Ari's MCP server, a published OpenAPI spec, Markdown on every URL, and two open-source CLIs — everything you need to make Ariso programmable, documented at fixed addresses.

Connect the MCP server OpenAPI spec Open source

Ari MCP Server

Connect Claude, Claude Code, or ChatGPT to your Ari workspace over Streamable HTTP and call meetings, follow-ups, reminders, and org memory as native tools. OAuth 2.1 with PKCE and dynamic client registration.

Setup guide

OpenAPI specification

OpenAPI 3.1 description of ariso.ai's public HTTP endpoints — lead capture, newsletter, blog share counts, and Open Graph image rendering — with an operationId, typed parameters, and response schemas on every operation.

/openapi.json

llms.txt

A condensed, plain-text guide to Ariso written for language models: what the product does, how it differs, and where every page lives. llms-full.txt carries the long-form version.

/llms.txt

Oats — open-source meeting notes

Free, open-source meeting notes for macOS and Windows. Records and transcribes on-device with a local model — no bot joins your call, and nothing leaves your machine unless you connect an Ariso account.

github.com/ariso-ai/oats

Ivan — open-source AI engineer CLI

A command-line AI teammate that ships pull requests. Breaks a request into PR-sized tasks, writes the code on Claude Code, reviews its own work, opens the PR, and handles review comments and failing CI. Runs locally with your own credentials.

github.com/ariso-ai/ivan

Trust & security

How Ariso handles your data: encryption, retention, subprocessors, and the compliance posture behind every integration and API call.

Read the details

Machine-readable

Every entry point, at a predictable URL

No key, no account, no rate limit. Fetch any of these directly.

Machine-readable entry points published by ariso.ai, with the content type each returns and what it contains.
Path	Content type	What it is
`/openapi.json`	`application/json`	OpenAPI 3.1 spec for the public HTTP API. Also at /.well-known/openapi.json.
`/api/v1/*`	`application/json`	The versioned API surface every operation in the spec lives under. Responses carry Ariso-Api-Version and RateLimit-* headers.
`/.well-known/mcp.json`	`application/json`	MCP server descriptor (registry server.json format) pointing at https://mcp.ari.ariso.ai/mcp.
`/llms.txt`	`text/plain`	Condensed guide to Ariso for language models.
`/llms-full.txt`	`text/plain`	Long-form guide, including full page and blog content.
`/sitemap.xml`	`application/xml`	Every indexable URL, with last-modified dates.
`/rss.xml`	`application/rss+xml`	Blog feed.
`/{any-page}.md`	`text/markdown`	Markdown representation of any page. Also served on the canonical URL when the request sends Accept: text/markdown.

Quickstart

Three ways in

Connect an agent to Ari over MCP

Add the Streamable HTTP server to any MCP client. You sign in with your Ari account in a browser popup — the client never sees your password.

# Claude Code
claude mcp add --transport http ari https://mcp.ari.ariso.ai/mcp

# stdio-only clients
npx -y mcp-remote https://mcp.ari.ariso.ai/mcp

Read any page as Markdown

Content negotiation on every URL, plus a .md sibling for crawlers that send no Accept header. Responses carry Vary: Accept.

curl -H "Accept: text/markdown" https://ariso.ai/ari
curl https://ariso.ai/blog/ai-as-an-operating-partner.md

Call the public HTTP API

No authentication. Every error comes back as JSON with a stable code and a hint describing how to fix the request.

curl https://ariso.ai/openapi.json

curl -X POST https://ariso.ai/api/v1/subscribe \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","source":"API"}'

Versioning & deprecation

The major version is in the path — every documented operation lives under /api/v1/, and every response carries an Ariso-Api-Version header. Integrate against the versioned paths; the unversioned /api/* aliases exist for this website's own forms. Breaking changes ship as a new major version at a new path alongside the old one; additive changes ship in place, so ignore fields you don't recognize. When something is retired its responses carry Deprecation and Sunset headers with at least six months between them. Nothing is deprecated today.

Rate limits

Applied per client IP in a fixed window, and different per endpoint — the form endpoints allow 5–10 requests per 10 minutes, share counts 120. Every response carries RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (seconds until the window resets) and RateLimit-Policy, so you can pace yourself rather than discover the limit by being refused. A 429 adds Retry-After. Each operation's exact policy is in the OpenAPI document.

Authentication

The public endpoints on ariso.ai need no credentials. Anything that touches your workspace data goes through the Ari MCP server, which uses OAuth 2.1 with PKCE and dynamic client registration — you approve access in a browser and can revoke it at any time, and every tool call carries a short-lived bearer token scoped to read or write. Protected-resource metadata is published at /.well-known/oauth-protected-resource on the MCP host. Product documentation lives at the Ari docs.

Give your agents a workplace.

Ari is the management layer your assistant is missing — real meetings, real follow-ups, real org memory, exposed as tools.

Connect the MCP server Talk to us