What can I do with the Intellibiz AI public API?

You can check service health, read the OpenAPI 3.0 specification, run public site search, and connect an AI client to the MCP JSON-RPC endpoint to list and call tools.

Do I need an API key to call the documented endpoints?

Discovery endpoints such as /health, /openapi.json, /sitemap.xml, /robots.txt and the well-known metadata documents are public. Tool calls that read or write account data require an OAuth 2.1 access token obtained through the documented authorization server.

How do AI agents discover the platform automatically?

Agents fetch /.well-known/api-catalog for the link set, /.well-known/oauth-protected-resource for authorization metadata, and /.well-known/agent-skills/index.json for machine-readable skill descriptors.

Which MCP methods are supported?

The endpoint implements JSON-RPC 2.0 initialize, tools/list and tools/call, and returns standard JSON-RPC error codes from -32700 through -32603.

Can I get the documentation as Markdown for an LLM?

Yes. Send the header Accept: text/markdown to /, /login, /signup or /docs and the server returns a Markdown rendering of the page instead of HTML.

← Home

Intellibiz AI — Service Documentation

Public, agent-discoverable endpoints. Replace YOUR-DOMAIN with your deployment hostname.

Endpoints

GET /health — service status
GET /openapi.json — OpenAPI 3.0 spec
GET /sitemap.xml — sitemap
GET /robots.txt — robots
GET /api/search?q=… — public site search
POST /mcp — MCP JSON-RPC 2.0 endpoint
GET /mcp/health — MCP readiness probe
GET /mcp/tools.json — MCP tools manifest

Well-known discovery — verify with curl

OAuth Protected Resource (RFC 9728)

curl -sS https://YOUR-DOMAIN/.well-known/oauth-protected-resource

OpenID Connect discovery

curl -sS https://YOUR-DOMAIN/.well-known/openid-configuration

API Catalog (RFC 9727 link set)

curl -sS -H 'Accept: application/linkset+json' https://YOUR-DOMAIN/.well-known/api-catalog

MCP server card

curl -sS https://YOUR-DOMAIN/.well-known/mcp/server-card.json

Agent skills index

curl -sS https://YOUR-DOMAIN/.well-known/agent-skills/index.json

Agent skill descriptor (Markdown)

curl -sS -H 'Accept: text/markdown' https://YOUR-DOMAIN/.well-known/agent-skills/search/SKILL.md

MCP — verify with curl

MCP readiness probe

curl -sS https://YOUR-DOMAIN/mcp/health

MCP tools manifest

curl -sS https://YOUR-DOMAIN/mcp/tools.json

JSON-RPC initialize

curl -sS -X POST https://YOUR-DOMAIN/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

JSON-RPC tools/list

curl -sS -X POST https://YOUR-DOMAIN/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

JSON-RPC tools/call (search)

curl -sS -X POST https://YOUR-DOMAIN/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search","arguments":{"query":"agent"}}}'

JSON-RPC error codes

-32700 Parse error (invalid JSON body)
-32600 Invalid Request (bad jsonrpc/method shape)
-32601 Method not found / unknown tool
-32602 Invalid params
-32603 Internal error

Markdown content

Send Accept: text/markdown to /, /login, /signup, or /docs to receive a Markdown rendering of the page.

Frequently asked questions

What can I do with the Intellibiz AI public API?: You can check service health, read the OpenAPI 3.0 specification, run public site search, and connect an AI client to the MCP JSON-RPC endpoint to list and call tools.
Do I need an API key to call the documented endpoints?: Discovery endpoints such as /health, /openapi.json, /sitemap.xml, /robots.txt and the well-known metadata documents are public. Tool calls that read or write account data require an OAuth 2.1 access token obtained through the documented authorization server.
How do AI agents discover the platform automatically?: Agents fetch /.well-known/api-catalog for the link set, /.well-known/oauth-protected-resource for authorization metadata, and /.well-known/agent-skills/index.json for machine-readable skill descriptors.
Which MCP methods are supported?: The endpoint implements JSON-RPC 2.0 initialize, tools/list and tools/call, and returns standard JSON-RPC error codes from -32700 through -32603.
Can I get the documentation as Markdown for an LLM?: Yes. Send the header Accept: text/markdown to /, /login, /signup or /docs and the server returns a Markdown rendering of the page instead of HTML.