---
ref: tool:heyreagent/find-unanswered-conversations
name: Find unanswered conversations
company: company:heyreagent
workflows: []
access: [mcp, api]
tags: [capability:search-conversations, category:sales-engagement, has:api, has:mcp]
docs: https://heyreagent.com/docs/actions/who_is_waiting_on_me
updated: 2026-10-25
---

# Find unanswered conversations

Returns the people whose last LinkedIn message you have not answered, across your live LinkedIn accounts.

Note: Reads the stored copy of the inbox: when needsInboxSync names an account, run sync_inbox first. To answer, pass the row's profileUrl to send_message; profileUrl can be null. Up to 200 people per call.

## Set up

Use the first option your agent supports.

### MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

```json
{ "mcpServers": { "heyreagent": { "url": "https://api.heyreagent.com/mcp" } } }
```

Call the MCP tool `who_is_waiting_on_me`.

Server URL: https://api.heyreagent.com/mcp

Note: Claude and ChatGPT sign in to HeyReagent in the browser, with no key. Connect the LinkedIn account on heyreagent.com first. Each tool has the same name and inputs as the API action.

### API (official)

- Base URL: https://api.heyreagent.com
- Endpoint: `POST /v1/actions/who_is_waiting_on_me`
- Auth: send the header `Authorization: Bearer $HEYREAGENT_API_KEY`
- Get a key: https://heyreagent.com/t
- Docs: https://heyreagent.com/docs

Note: Every action is a POST to /v1/actions/<name> with its inputs as a JSON body, reads included. Create the key under Menu, then Developers; it is shown once. An answer is { ok: true, result } or { ok: false, error, message }.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.