Skip to main content
POST
Send feedback to the MCPJam team

Authorizations

Authorization
string
header
required

MCPJam API key (sk_…). Create one at Settings → API keys. Guest sessions cannot use the API, and API keys cannot manage other API keys.

Headers

Idempotency-Key
string

Retry-safe report key, validated STRICTLY. Replaying the SAME key with the SAME report returns the original receipt; reusing it for DIFFERENT content is a 409. A header that is present but empty, or longer than 256 characters, is a 400, never silently ignored. x-mcpjam-idempotency-key is accepted as an alternative spelling; sending both with different values is a 400.

Required string length: 1 - 256
x-mcpjam-launcher
string

The launching process's own DECLARED identity, as compact JSON: {"kind":"cli"|"mcp"|"github_action","client":"…","version":"…"}. Stored on the run as launcher and used only as a display label — source stays api and the audit trail reads the platform-minted attribution instead.

A header rather than a body field so that sending it never breaks against an older deployment: both eval-run bodies reject unknown properties, while an unknown header is ignored everywhere. For the same reason a malformed value, or a kind outside the three above, is DROPPED rather than rejected — a label must never fail a launch. Max 512 bytes.

Body

application/json

The report.

kind
enum<string>
required

What sort of problem this is.

Available options:
bug,
missing_capability,
confusing,
docs,
other
summary
string
required

One line: what went wrong or what is missing. Trimmed. Appears in the team's notification.

Required string length: 1 - 200
details
string

What you were trying to accomplish, what you expected, and what blocked you. For a missing capability, name the task and any workaround you tried; there may be no request id. Summarize; never paste secrets, tokens, or raw tool output. Stored only in MCPJam's database, never emailed, and deleted after 180 days.

Maximum string length: 8000
operation
string

The tool, CLI command or app page in use.

Maximum string length: 120
requestId
string

The failing call's x-request-id, when there is one.

Maximum string length: 128
errorCode
string

The failing call's error code, e.g. INTERNAL_ERROR.

Maximum string length: 64
projectId
string

A project you can see, when the report is about one; anything else is a 404. Omit it otherwise: no project is assumed.

Response

The report is stored. duplicate: true means an identical report from you was already recorded.

id
string
required

The stored report's id.

receivedAt
number
required

When the report was received, in epoch milliseconds.

duplicate
boolean
required

True when an identical report from you was already recorded in the last 24 hours; id is that report.