---
title: "Paireeo public API and MCP documentation"
description: "Official public information from Paireeo Inc."
canonical: https://paireeo.info/docs
last-updated: 2026-10-03
---

# Paireeo public API and MCP documentation

Use these keyless, read-only tools to find Paireeo's published business information. No registration, API key, or payment is required. They cannot read client information, submit forms, reserve build weeks, sign contracts, or take payments.

## Read public sources

GET https://paireeo.info/api/public/pages lists the published pages. Add ?path=/foundation to read one page, or ?query=what%20does%20the%20build%20include to search. Only allowlisted paths are accepted. Unknown and private paths return 404.

## Natural-language search (NLWeb)

GET https://paireeo.info/ask?query=what%20does%20the%20build%20include or POST /ask with {"query":"what does the build include","prefer":{"mode":"list","streaming":false}} returns relevant public-source excerpts with links. This is source search, not a generated answer or commercial commitment. JSON responses follow NLWeb 0.55; prefer.streaming=true enables start, result, complete SSE events. No matches returns an empty results list.

## MCP

Streamable HTTP endpoint: https://paireeo.info/mcp
Tools: search_public_information(query), read_public_page(path). Both are read-only and closed to external URLs. Supports initialization, tools/list, tools/call, resources/list, resources/read, and ping. No login or session state is needed. Private Paireeo services have separate sign-in and do not inherit access from this server.

## Browser tools (WebMCP)

On public pages, compatible browsers can use search_paireeo and read_paireeo_page. In browsers without WebMCP the normal website works unchanged.

## Errors and limits

Queries must be 1 to 500 characters. JSON request bodies are limited to 16 KiB. Page paths are restricted to the documented public corpus. Invalid JSON or arguments return 400; unknown paths return 404; unsupported methods return 405; oversized bodies return 413. MCP errors use JSON-RPC error codes or tool isError results. Hosting may rate-limit requests with HTTP 429; honor Retry-After if provided. Tools never fetch an arbitrary supplied URL. Do not send personal, confidential, or credential data in a query.

OpenAPI: https://paireeo.info/api/openapi.json
Agent skills: https://paireeo.info/.well-known/agent-skills/index.json
Discovery catalog: https://paireeo.info/.well-known/ard.json
Authentication boundaries: https://paireeo.info/auth.md