`amp_get_user_activity`

Pack: amplitude · Endpoint: https://gateway.pipeworx.io/amplitude/mcp

Get recent event activity timeline for a specific user. Returns events with timestamps, properties, and interactions.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	Amplitude API key
`_secretKey`	string	yes	Amplitude secret key
`amplitude_id`	string	yes	Amplitude internal user ID (from amp_user_search results)
`offset`	number	no	Pagination offset (default 0)
`limit`	number	no	Max events to return (default 100, max 1000)

Example call

Arguments

{
  "_apiKey": "your-amplitude-api-key",
  "_secretKey": "your-amplitude-secret-key",
  "amplitude_id": "5f8c1a2b9e4d5c6f7g8h9i0j"
}

curl

curl -X POST https://gateway.pipeworx.io/amplitude/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"amp_get_user_activity","arguments":{"_apiKey":"your-amplitude-api-key","_secretKey":"your-amplitude-secret-key","amplitude_id":"5f8c1a2b9e4d5c6f7g8h9i0j"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('amp_get_user_activity', {
  "_apiKey": "your-amplitude-api-key",
  "_secretKey": "your-amplitude-secret-key",
  "amplitude_id": "5f8c1a2b9e4d5c6f7g8h9i0j"
});

More examples

{
  "_apiKey": "your-amplitude-api-key",
  "_secretKey": "your-amplitude-secret-key",
  "amplitude_id": "5f8c1a2b9e4d5c6f7g8h9i0j",
  "offset": 100,
  "limit": 50
}

Response shape

Field	Type	Description
`events`	array	Recent events for user
`user`	object	User identification

Full JSON Schema

{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "event_type": {
            "type": "string",
            "description": "Event name"
          },
          "timestamp": {
            "type": "number",
            "description": "Unix timestamp in milliseconds"
          },
          "properties": {
            "type": "object",
            "description": "Event-specific properties"
          },
          "session_id": {
            "type": "string",
            "description": "Session identifier"
          },
          "device_id": {
            "type": "string",
            "description": "Device identifier"
          }
        }
      },
      "description": "Recent events for user"
    },
    "user": {
      "type": "object",
      "properties": {
        "amplitude_id": {
          "type": "string",
          "description": "Amplitude user ID"
        },
        "user_id": {
          "type": "string",
          "description": "App user ID"
        }
      },
      "description": "User identification"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "amplitude": {
      "url": "https://gateway.pipeworx.io/amplitude/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

amp_get_user_activity