get_activity
Retrieve recent activity logs for outreach agents to monitor actions taken and results achieved in LinkedIn, Email, X, Instagram, and Blog campaigns.
Instructions
Get recent activity log entries for an agent or all agents. Shows what actions were taken and their results.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agentId | No | Filter by agent ID (optional, returns all if omitted) | |
| limit | No | Number of entries to return (default 20) |
Implementation Reference
- src/tools/analytics.ts:44-50 (handler)The handler function for 'get_activity' tool which calls the API client to fetch activity data.
handler: async (args: Record<string, unknown>) => { const activity = await client.getActivity( args.agentId as string | undefined, args.limit as number | undefined, ); return JSON.stringify(activity, null, 2); }, - src/tools/analytics.ts:30-51 (registration)Tool definition and registration for 'get_activity' within 'getAnalyticsTools'.
{ name: 'get_activity', description: 'Get recent activity log entries for an agent or all agents. Shows what actions were taken and their results.', inputSchema: { type: 'object' as const, properties: { agentId: { type: 'string', description: 'Filter by agent ID (optional, returns all if omitted)', }, limit: { type: 'number', description: 'Number of entries to return (default 20)' }, }, }, handler: async (args: Record<string, unknown>) => { const activity = await client.getActivity( args.agentId as string | undefined, args.limit as number | undefined, ); return JSON.stringify(activity, null, 2); }, }, - src/api-client.ts:72-75 (helper)API client method that performs the actual HTTP request to retrieve activity data.
async getActivity(agentId?: string, limit = 20) { const qs = agentId ? `?agentId=${agentId}&limit=${limit}` : `?limit=${limit}`; return this.request('GET', `/api/activity${qs}`); }