mcp_analytics

Create a new MCP feedback submission for the current project.

post/api/projects/{project_id}/mcp_analytics/feedback/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/mcp_analytics/feedback/
  • Auth: HTTP bearer

Path parameters

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

attempted_toolstring

The tool the user tried before leaving feedback, if known.

mcp_client_namestring

MCP client name, for example Claude Desktop or Cursor.

mcp_client_versionstring

Version string for the MCP client when available.

mcp_protocol_versionstring

MCP protocol version negotiated for the session when available.

mcp_transportstring

Transport used for the MCP session, for example streamable_http or sse.

mcp_session_idstring

Stable MCP session identifier when available.

mcp_trace_idstring

Trace identifier for the surrounding MCP workflow when available.

goalstring required

The user's intended outcome when using MCP.

feedbackstring required

Concrete feedback about the MCP experience, tool result, or workflow friction.

category'results' | 'usability' | 'bug' | 'docs' | 'other'
  • results - Results
  • usability - Usability
  • bug - Bug
  • docs - Docs
  • other - Other

Response

idstring uuid required

Unique identifier for this submission.

kind'feedback' | 'missing_capability' required
  • feedback - Feedback
  • missing_capability - Missing capability
goalstring required

The user's goal in plain language.

summarystring required

The core feedback or missing capability request.

categorystring required

Feedback category when present. Empty for submissions that do not use categories.

blockedboolean nullable required

Whether the missing capability blocked progress. Null when not provided.

attempted_toolstring required

The tool the user tried before submitting this feedback, if known.

mcp_client_namestring required

MCP client name captured alongside the submission when available.

mcp_client_versionstring required

MCP client version captured alongside the submission when available.

mcp_protocol_versionstring required

MCP protocol version captured alongside the submission when available.

mcp_transportstring required

MCP transport captured alongside the submission when available.

mcp_session_idstring required

MCP session identifier captured alongside the submission when available.

mcp_trace_idstring required

MCP trace identifier captured alongside the submission when available.

created_atstring date-time required

When this submission was created.

updated_atstring date-time required

When this submission was last updated.

Changes

No recorded changes to this operation across all 1 revision of this API.