# Maple.inc developer resources — Maple API, OpenAPI, webhooks, MCP

> Canonical: https://maple.inc/developers

Maple Voice AI (Maple) publishes developer resources on maple.inc so agents and engineers can find the Maple API by name.

## Maple Developer API

- [Maple Developer API](https://docs.maple.inc/developer-api/overview): POS and platform partner API overview
- [Maple Developer API OpenAPI](https://docs.maple.inc/openapi/developer-api.json): Partner API operations and schemas
- [Maple API authentication](https://docs.maple.inc/developer-api/concepts/authentication): Bearer keys, scopes and onboarding
- [Maple API environments](https://docs.maple.inc/developer-api/concepts/environments): Sandbox and production hosts
- [Maple API webhooks](https://docs.maple.inc/developer-api/concepts/webhooks): Subscriptions, signatures and delivery handling
- [Maple Developer API errors](https://docs.maple.inc/developer-api/concepts/errors): Partner API error tags and recovery

Partner production: https://api.maple.inc/v1. Sandbox: https://api.staging.maple.inc/v1. Bearer keys come from Maple onboarding; scopes and location grants limit access. Use the linked auth and environment guides. Do not send partner credentials to maple.inc.

## Maple website API and OpenAPI

- OpenAPI: https://maple.inc/openapi.json
- RFC 9727 API catalog: https://maple.inc/.well-known/api-catalog
- Versioned JSON index: https://maple.inc/api/v1 (alias https://maple.inc/api)
- Maple API docs: https://maple.inc/api-docs
- Errors: RFC 9457 application/problem+json with code, message, detail, hint

## Versioning and deprecation

URL path versioning. Current version is v1 at /api/v1. Unversioned /api is an alias of v1. Breaking changes ship as /api/v2. Retired website API versions send RFC 9745 Deprecation (Structured Field Date, such as @1798761600) and RFC 8594 Sunset (HTTP-date) with at least 90 days between them. v1 is current and sends no retirement dates. Responses include API-Version: 1 and Link rel="deprecation" to https://maple.inc/developers#versioning. This policy applies to the website API, not the separate partner API.

## Maple MCP server

- Streamable HTTP: https://maple.inc/mcp
- Server card: https://maple.inc/.well-known/mcp.json
- Copy: https://maple.inc/.well-known/mcp/server-card.json

Tools are read-only (product, pricing, integrations, developer links). There is no merchant-data API on this host.

## Docs, webhooks, help

- Maple Docs: https://docs.maple.inc/ (machine index https://docs.maple.inc/llms.txt)
- Help Center: https://help.maple.inc/
- Partner webhooks: https://docs.maple.inc/developer-api/concepts/webhooks
- CLI setup and commands: https://maple.inc/developers/cli

The website operations and public MCP require no credentials. The partner API uses its own typed error contract, documented at https://docs.maple.inc/developer-api/concepts/errors.

## Agent indexes

- https://maple.inc/llms.txt
- https://maple.inc/llms-full.txt
- https://maple.inc/sitemap.xml