get_space_members
Retrieve a list of members with access to an Anytype space, including their IDs, names, and permission levels. Use this tool to view collaborators and manage space access permissions.
Instructions
Retrieves a list of all members who have access to a specified Anytype space. This tool provides information about each member including their ID, name, and access level. Results are paginated for spaces with many members. Use this tool when you need to understand who has access to a space or manage collaboration permissions.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| space_id | Yes | Space ID to get members from | |
| offset | No | Pagination offset | |
| limit | No | Number of results per page (1-1000) |
Implementation Reference
- src/index.ts:349-371 (handler)The handler function for the 'get_space_members' tool. It validates the limit parameter, makes a GET request to the Anytype API endpoint `/spaces/${space_id}/members` with pagination parameters, and returns the JSON response or handles errors using the shared error handler.
async ({ space_id, offset, limit }) => { try { // Validate limit const validLimit = Math.max(1, Math.min(1000, limit)); const response = await this.makeRequest( "get", `/spaces/${space_id}/members`, null, { offset, limit: validLimit } ); return { content: [ { type: "text" as const, text: JSON.stringify(response.data, null, 2), }, ], }; } catch (error) { return this.handleApiError(error); } } - src/index.ts:340-348 (schema)Zod schema defining the input parameters for the 'get_space_members' tool: space_id (required string), offset (optional number, default 0), limit (optional number, default 100).
{ space_id: z.string().describe("Space ID to get members from"), offset: z.number().optional().default(0).describe("Pagination offset"), limit: z .number() .optional() .default(100) .describe("Number of results per page (1-1000)"), }, - src/index.ts:337-372 (registration)The complete registration of the 'get_space_members' tool using this.server.tool(), including the tool name, description, input schema, and inline handler function.
this.server.tool( "get_space_members", "Retrieves a list of all members who have access to a specified Anytype space. This tool provides information about each member including their ID, name, and access level. Results are paginated for spaces with many members. Use this tool when you need to understand who has access to a space or manage collaboration permissions.", { space_id: z.string().describe("Space ID to get members from"), offset: z.number().optional().default(0).describe("Pagination offset"), limit: z .number() .optional() .default(100) .describe("Number of results per page (1-1000)"), }, async ({ space_id, offset, limit }) => { try { // Validate limit const validLimit = Math.max(1, Math.min(1000, limit)); const response = await this.makeRequest( "get", `/spaces/${space_id}/members`, null, { offset, limit: validLimit } ); return { content: [ { type: "text" as const, text: JSON.stringify(response.data, null, 2), }, ], }; } catch (error) { return this.handleApiError(error); } } );