Documentation · MCP and agent API

A clear contract for agent capabilities.

Kairaxis provides authenticated discovery, task resolution and exact reads of reviewed packages and visual references. Generate an API key on the MCP setup page, then connect your agent.

Explore the API Set up MCP and API keys

System principles

What the registry guarantees.

Agent-native access

Use MCP or authenticated REST to search, resolve and read relevant guidance on demand.

Portable packages

Reviewed packages expose pinned versions, complete manifests, source licenses and exact file hashes.

Evidence first

Delivery readiness, provenance and limitations stay beside each item. Package validation does not imply measured task quality.

Agent API

The registry, machine-readable.

Agent endpoints require Authorization: Bearer with a scoped personal token. Search needs catalog:read; instruction and file delivery also need content:read. Generate, verify and revoke keys from the MCP setup page.

After setting KAIRAXIS_MCP_TOKEN in your terminal, search the catalog:

curl 'https://www.kairaxis.com/api/agent/catalog?query=layout&limit=5' \
  -H "Authorization: Bearer $KAIRAXIS_MCP_TOKEN"

POSThttps://mcp.kairaxis.com/mcp

Streamable HTTP MCP: kairaxis_search, kairaxis_resolve and kairaxis_get.

GET/api/agent/catalog

Browse eligible summaries, facets, delivery readiness and paginated results.

POST/api/agent/resolve

Resolve a task into a bounded selection with reasons, prerequisites and uncovered needs.

GET/api/agent/content

Read pinned metadata or exact reviewed text using item_id and version_id; file reads also require file_id.

GET/api/v1/skills

Legacy authenticated skill summaries; no installation or instruction bodies.

GET/api/v1/prompts

Legacy authenticated prompt summaries; inspect delivery readiness before requesting content.

Trust workflow

Evidence before execution.

Browse marketplace

1
Discover
Search summaries or resolve the current task.
2
Inspect
Check readiness, source, permissions and prerequisites.
3
Read
Retrieve complete reviewed files at the selected version.
4
Apply
Use the guidance within the user’s brief and evaluate the actual result.

MCP does not run packages or write to your local filesystem. Legacy install, claim and sandbox agent endpoints return not_implemented. Public topic tags do not establish business-industry expertise; the resolver reports missing coverage.