# Maple

> Maple is an open-source observability platform for traces, logs, and metrics, built on OpenTelemetry and backed by ClickHouse. Send OTLP from any instrumented app — no proprietary agents.

For AI agents and automation, use the resources below.

## Documentation

Append `.md` to any docs URL, or send `Accept: text/markdown`, to receive the raw markdown source.

- [Docs index (Markdown)](https://maple.dev/docs.md)
- [Docs index (HTML)](https://maple.dev/docs)
- [Full documentation, single file](https://maple.dev/llms-full.txt)
- Example: [https://maple.dev/docs/getting-started/introduction.md](https://maple.dev/docs/getting-started/introduction.md)

## Pricing

Plans, included volume, and per-GB overage for logs, traces, metrics, and browser sessions.

- [Pricing (Markdown)](https://maple.dev/pricing.md)
- [Pricing (HTML)](https://maple.dev/pricing)

## Changelog

Maple product updates, month by month. The index enumerates every release. Append `.md` to any changelog URL, or send `Accept: text/markdown`, to receive the raw markdown source.

- [Changelog index (Markdown)](https://maple.dev/changelog.md)
- [Changelog index (HTML)](https://maple.dev/changelog)
- [RSS feed](https://maple.dev/changelog/rss.xml)

## Roadmap

What has shipped, what is being built, and what is being explored.

- [Roadmap (Markdown)](https://maple.dev/roadmap.md)
- [Roadmap (HTML)](https://maple.dev/roadmap)

## Features

One page per capability — tracing, session replay, logs, metrics, service catalog, error tracking, MCP, Kubernetes. Append `.md` to any feature URL, or send `Accept: text/markdown`, to receive the raw markdown source.

- [Distributed Tracing](https://maple.dev/features/distributed-tracing.md)
- [Browser Sessions](https://maple.dev/features/browser-sessions.md)
- [Log Management](https://maple.dev/features/log-management.md)
- [Metrics & Dashboards](https://maple.dev/features/metrics-dashboards.md)
- [Service Catalog & Map](https://maple.dev/features/service-catalog.md)
- [Error Tracking](https://maple.dev/features/error-tracking.md)
- [Alerting](https://maple.dev/features/alerts.md)
- [AI & MCP Integration](https://maple.dev/features/ai-mcp-integration.md)
- [Kubernetes Monitoring](https://maple.dev/features/kubernetes-monitoring.md)

## Use cases

Worked debugging stories, step by step. Append `.md` to any use-case URL, or send `Accept: text/markdown`, to receive the raw markdown source.

- [API Performance](https://maple.dev/use-cases/api-performance.md)
- [E-Commerce Observability](https://maple.dev/use-cases/ecommerce-observability.md)
- [Microservices Debugging](https://maple.dev/use-cases/microservices-debugging.md)

## Guides

Evergreen explanations of application performance monitoring, observability, OpenTelemetry, and the tools used to operate production software.

- [Guides index](https://maple.dev/guides)
- [What is APM, and why is it important?](https://maple.dev/guides/what-is-apm)
- [What is observability?](https://maple.dev/observability)
- [What is OpenTelemetry?](https://maple.dev/opentelemetry)
- [Best open-source observability tools](https://maple.dev/best-open-source-observability-tools)

## Maple API

REST API for the Maple observability platform, base URL `https://api.maple.dev/v2`. Bearer auth with a Maple API key (`maple_ak_…`); JSON in and out; every error is a `{ "error": { "_tag", "type", "code", "message" } }` envelope; 600 requests/minute per key with `Retry-After` on 429.

- [Maple API guide](https://maple.dev/docs/api.md) — authentication, conventions, errors, rate limits
- [OpenAPI 3.1 specification (JSON)](https://maple.dev/openapi.json) — every operation has an operationId, description, typed parameters and response schemas
- [Interactive API reference](https://api.maple.dev/v2/docs)
- [Same spec served by the API](https://api.maple.dev/openapi.json)

## MCP server

Maple exposes its API to AI agents as a hosted Model Context Protocol server over Streamable HTTP at `https://api.maple.dev/mcp`. Authenticate with a Maple API key as a Bearer token, or let the client complete the OAuth flow advertised at `https://api.maple.dev/.well-known/oauth-protected-resource/mcp`.

- [MCP server guide](https://maple.dev/docs/mcp.md) — connecting Claude, Cursor, and other clients; available tools
- [MCP server manifest (server.json)](https://maple.dev/.well-known/mcp.json) — also at https://maple.dev/.well-known/mcp/server.json and https://api.maple.dev/.well-known/mcp.json
- [AI & MCP feature page](https://maple.dev/features/ai-mcp-integration.md)

## Command line tool

The official `maple` CLI runs the whole platform locally against a single embedded ClickHouse binary — no account required — and talks to the hosted service for the rest.

- Homebrew: `brew install Makisuo/tap/maple`
- Install script: `curl -fsSL https://maple.dev/cli/install | sh` ([source](https://maple.dev/cli/install))
- [Releases on GitHub](https://github.com/MapleTechLabs/maple/releases)
- [CLI reference](https://maple.dev/docs/local-mode/cli-reference.md)

## SDKs and instrumentation

Maple ingests OpenTelemetry, so any OTel SDK works unmodified. The Effect SDK and the per-language guides are documented here.

- [SDK overview](https://maple.dev/docs/sdks/overview.md)
- [Effect SDK](https://maple.dev/docs/sdks/effect.md)
- [Repository](https://github.com/MapleTechLabs/maple)

## Brand

Logo, wordmark, colours, and type, with a downloadable kit. Use the artwork as it is rather than redrawing it.

- [Brand assets (Markdown)](https://maple.dev/brand.md)
- [Brand assets (HTML)](https://maple.dev/brand)
- [Brand kit archive](https://maple.dev/brand/maple-brand-kit.zip)

## Company

Maple is built and operated by Makisuo, Inc.

- [About Maple (Markdown)](https://maple.dev/about.md)
- [About Maple (HTML)](https://maple.dev/about)
- [Contact (Markdown)](https://maple.dev/contact.md)
- [Contact (HTML)](https://maple.dev/contact)
- [Privacy policy](https://maple.dev/privacy)
- [Terms of service](https://maple.dev/terms)

## Community

- [Discord](https://discord.gg/BnXjKuwJqP)
- [X](https://x.com/Mapledotdev)