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

# Paireeo public API, MCP and reservation 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.

## Foundation Build reservation API

GET https://reserve.paireeo.site/api/agent returns current shared-calendar availability, the CAD $6,000 base price, CAD $1,200 reservation deposit, full terms, terms version and hash, supported payment modes and request schemas. This read creates no reservation, hold or payment. Customer page: https://reserve.paireeo.site/. Terms: https://reserve.paireeo.site/terms.

Before POSTing to the same reservation endpoint, show the customer the exact selected week, business/contact details, custom request, CAD $1,200 charge and complete terms. Obtain explicit customer confirmation and authority to act for the business. Use the returned request schema and current terms version/hash. Authorization must bind the exact reservation; a changed or expired request requires fresh approval and new IDs.

For hosted_stripe_checkout, POST returns a time-limited Stripe Checkout URL. Send it to the customer to review and approve payment. For supported wallet completion, obtain a fresh customer-approved Stripe Link Shared Payment Token for exactly CAD $1,200 and follow the live wallet request schema. Never send card numbers or log payment tokens. Check the live available flags before offering either mode; not every AI provider supports this integration.

Generate requestId and authorization id once and retain the complete unchanged request on retries. A wallet payment response is not proof of a confirmed week: Stripe's signed successful-payment webhook confirms the reservation through the shared calendar. The deposit is credited toward the build price when applied. Cancellation before work starts under the new reservation terms returns the deposit less actual Stripe processing fees. Custom requests are included only after separate agreement on scope and price. Both parties must sign the full scope contract before the reserved build week starts.

This reservation API is separate from the read-only source tools below. Finding its instructions does not grant customer authority or access to private client data.

## Authentication

Authentication: none. All public information endpoints are keyless.

## Read public sources

GET https://paireeo.info/api/public/pages lists the published pages. Use limit=1..50 (default 20) and the returned nextCursor until it is null. 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":{"text":"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.

## API versioning

REST requests accept API-Version: 1 (the default) and return API-Version: 1. Other versions return 400 UNSUPPORTED_VERSION. Version 1 keeps compatible fields; breaking changes require a new version and documentation. Deprecation will be announced with Deprecation and Sunset response headers before an old version is removed. POST source search is read-only, so retries cannot create records or charges. No asynchronous jobs are used.

## Errors and limits

REST failures include error.code, error.message and error.hint. 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