Skip to content
problems

Getting started with problems.dev

@problemsdev/sdk is a zero-dependency library you embed in your own CLI or MCP server. When an agent hits a failure using your tool, it reports the failure to your problems.dev inbox. If you’ve published a fix, the agent gets it back on the same call.

Errors only. No usage telemetry, no analytics, no sessions.

Install

Section titled “Install”
Terminal window
npm install @problemsdev/sdk

Zero dependencies, Node 18+, ships ESM and CommonJS.

Initialize

Section titled “Initialize”

Create one client with your provider slug, the subdomain your surface lives at (https://<slug>.problems.dev):

import { createProblems } from "@problemsdev/sdk";


const problems = createProblems({ slug: "acme" });

slug is the only required option. See Configuration for the rest.

Pick your surface

Section titled “Pick your surface”

Wire the client into your tool in one of two places:

  • MCP server: wrap your server to report handler failures and return known fixes in error results. Opt into exception mapping to return fixes for selected thrown errors.
  • CLI: add one report() call to your top-level catch.

Both are a few lines and safe to leave in. report() never throws, and delivery is bounded.