Finds somebody by name so you can ask to be friends
GET /api/v1/social/people - Sign-in
- No scope
- Scope
- None
- MCP tool
social.find
Parameters
| Field | Type and meaning |
|---|
q query | string Part of somebody's name. At least two characters. |
|---|
Response 200
| Field | Type and meaning |
|---|
items always | array of object |
|---|
items[].avatar | string |
|---|
items[].id always | string |
|---|
items[].name always | string |
|---|
items[].online | boolean |
|---|
items[].playing | string |
|---|
items[].since always | string |
|---|
items[].state always | string |
|---|
items[].unread | integer |
|---|
Errors
| Status | Type and meaning |
|---|
400 | The request was not understood. |
|---|
401 | Sign in and try again. |
|---|
404 | There is nothing here, or nothing you may see. |
|---|
429 | Too many requests. |
|---|
500 | Something on our side went wrong. |
|---|
Every error comes back as { code, message, requestId }. Errors