Find subscriber

Subscriber profile from Search, found by phone number, name or email.

MCP tool postscript_read → find_subscriber

read

Searches Postscript for one subscriber and returns the profile fields Postscript shows under Subscriber Details: status, subscriber ID, how and when they subscribed, tags, the last message sent, messages sent and link clicks. Use it before a reply or a segment to see who the person is.

Parameters

Parameters: find_subscriber
NameTypeDescription
query string required string Phone number, name or email.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "postscript_read",
    "arguments": {
      "operation": "find_subscriber",
      "arguments": {
        "query": "query"
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "subscribers": [
      {
        "subscriber_id": "7740215",
        "name": "Dana R.",
        "phone": "+1 555 0142",
        "status": "active",
        "subscribed_via": "keyword JOIN",
        "subscribed_at": "2026-06-02",
        "tags": [
          "vip"
        ],
        "last_message_at": "2026-10-21",
        "messages_sent": 14,
        "link_clicks": 3
      }
    ]
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.