llms.txt
Compare with other sites' llms.txt files →# Marsad
> Errors, traces, Web Vitals and cookieless analytics for Next.js and Expo apps — one drop-in SDK, no consent banner, and an MCP server Claude can query.
Marsad is an observability and product-analytics platform for Next.js and Expo / React Native apps — errors, network, performance traces, Web Vitals and cookieless analytics from one SDK. A single SDK (`@marsadco/sdk`) auto-detects its runtime (browser, Node or React Native) and captures unhandled errors, manual exceptions and network requests, then groups them into ranked issues with full, source-mapped stack traces and the breadcrumbs that led there.
Marsad is also AI-native: it hosts a remote MCP (Model Context Protocol) server, so Claude and other MCP clients can read a project's issues, symbolicated stack traces, performance traces and analytics — and triage issues — directly from chat, scoped by OAuth consent to one organization and a chosen set of permissions.
Beyond errors it tracks sessions and crash-free rate, Web Vitals (LCP/CLS/INP/FCP/TTFB), custom metrics, distributed performance traces (viewable as waterfalls) and user feedback tied to the exact issue — across web and mobile projects in one place. Cookieless page views are automatic in the browser, and on Expo / React Native screen views are captured via the useScreenViews() hook. Native iOS and Android crashes (signals, NSException, Kotlin/Java crashes, ANRs, C/C++ crashes) are captured in beta by the separate `@marsadco/react-native` package; native frames currently show as binary and address. Alerts reach you on Slack, email, webhook or Linear with dedupe and cooldowns (alerting is included on the paid plans).
Pricing is flat and per-org, never per-seat: Free (10,000 page views and 5,000 errors a month, 1 project, no credit card), Solo at $9/mo and Team at $29/mo for unlimited projects — Team adds unlimited members.
## Documentation
- [Quickstart](https://www.marsad.space/docs): Install @marsadco/sdk, initialize with your project key, and see your first events — Next.js or Expo.
- [SDK reference](https://www.marsad.space/docs/sdk-reference): Every init() option, method, the React ErrorBoundary, framework helpers, metrics, tracing and source maps.
- [Connect Claude & AI tools (MCP)](https://www.marsad.space/docs/mcp): Marsad's remote MCP server — connect Claude, Claude Code or any MCP client to your issues, stack traces and traces; the 14 tools, OAuth setup, API tokens and scopes.
- [Full docs as plain text](https://www.marsad.space/llms-full.txt): The Quickstart and SDK reference inlined for LLM ingestion.
## Product
- [Home](https://www.marsad.space/): Product overview, features and how it works.
- [Live demo](https://www.marsad.space/demo): A fully populated dashboard to explore without signing up.
- [Status](https://www.marsad.space/status): Current service health.
- [Community issues](https://www.marsad.space/community/issues): Public bug reports and questions about Marsad and its SDKs.
- [Pricing](https://www.marsad.space/pricing): Plans and limits — Free, Solo ($9/mo) and Team ($29/mo).
- [Sign up](https://www.marsad.space/signup): Create an account — free plan, no credit card.
## Blog
- [Cookieless analytics without a consent banner](https://www.marsad.space/blog/cookieless-analytics-without-a-banner): Counting unique visitors usually means storing an identifier on the device, which means a banner. Here is the rotating hash we use instead, and its limits.
- [One SDK for errors, traces, and traffic](https://www.marsad.space/blog/one-sdk-errors-traces-traffic): Most teams install an error tracker, an analytics script and something for Web Vitals — three vendors, one question. Marsad ships all three in one install.
- [What a trace shows you that a log can't](https://www.marsad.space/blog/what-a-trace-shows-that-a-log-cannot): A log line tells you a request was slow. A trace tells you which of the eleven things it did was slow, and whether the frontend or the backend owns it.
- [Flat pricing, not per-seat](https://www.marsad.space/blog/flat-pricing-not-per-seat): Per-seat pricing on an observability tool punishes you for letting people look at production. We priced per organization instead.
- [Introducing Marsad: errors and requests together](https://www.marsad.space/blog/introducing-marsad): We built Marsad because triaging production issues across web and mobile shouldn't mean stitching together three tools. Here's what it does and why.
- [How we symbolicate Hermes bundles](https://www.marsad.space/blog/symbolicating-hermes-bundles): Minified React Native stack traces are useless on their own. A look at how Marsad turns Hermes bytecode frames back into your real source.
- [Designing alert cooldowns that don't cry wolf](https://www.marsad.space/blog/designing-alert-cooldowns): Alerting is easy to get wrong — too quiet and you miss outages, too loud and people mute the channel. How we think about dedupe and cooldowns.
## Notes
- MCP: Marsad exposes a remote MCP server at `https://www.marsad.space/api/mcp` (streamable HTTP). AI clients authenticate with OAuth 2.1 (PKCE + dynamic client registration) or a personal access token (`mst_…`) as a Bearer header; 14 tools cover issues, events, symbolicated stack traces, transactions, traces, releases, logs, affected users, and issue triage (resolve/assign/comment). Scopes: read:issues, read:performance, read:analytics, write:issues. Setup guide: https://www.marsad.space/docs/mcp.
- Install: `npm install @marsadco/sdk` (Next.js) or `npx expo install @marsadco/sdk` (Expo).
- Initialize with `init()`; the project ingest key (`bk_live_…`) is read from `MARSAD_KEY` / `NEXT_PUBLIC_MARSAD_KEY` / `EXPO_PUBLIC_MARSAD_KEY`.
- Source maps: `npx marsad inject ./dist && npx marsad upload-sourcemaps ./dist` resolves minified web and Hermes frames to real files and lines.