Social

Social tools are available on the Voxvey MCP endpoint.

POST /v1/mcp

Tools

Tool	Purpose
x_search_posts	Search X posts for a query
x_get_profile	Fetch an X user profile
truthsocial_search	Search Truth Social posts or accounts
truthsocial_get_profile	Fetch a Truth Social profile
truthsocial_get_statuses	Fetch recent Truth Social statuses for a user

Search X posts

curl https://api.voxvey.com/v1/mcp \
  -H "Authorization: Bearer $VOXVEY_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 11,
    "method": "tools/call",
    "params": {
      "name": "x_search_posts",
      "arguments": {
        "query": "from:voxvey api",
        "raw": false
      }
    }
  }'

{
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[{\"id\":\"1930000000000000000\",\"text\":\"Voxvey API update\",\"author_id\":\"2244994945\",\"created_at\":\"2026-06-06T00:00:00Z\",\"metrics\":{\"likes\":4,\"retweets\":1,\"replies\":0,\"quotes\":0}}]"
      }
    ]
  },
  "jsonrpc": "2.0",
  "id": 11
}

Search Truth Social

{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "tools/call",
  "params": {
    "name": "truthsocial_search",
    "arguments": {
      "query": "api",
      "type": "statuses",
      "raw": false
    }
  }
}

Truth Social search returns normalized status or account records depending on the type argument.