get_types
Retrieve available object types in an Anytype space to understand what can be created or find correct type IDs for new objects.
Instructions
Retrieves all object types available in a specified Anytype space. This tool provides information about the different types of objects that can be created in the space, including their IDs, names, and metadata. Results are paginated for spaces with many types. Use this tool when you need to understand what types of objects can be created or to find the correct type ID for creating new objects.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| space_id | Yes | Space ID to get types from | |
| offset | No | Pagination offset | |
| limit | No | Number of results per page (1-100) |
Implementation Reference
- src/index.ts:375-410 (registration)Registration of the 'get_types' MCP tool, including input schema (space_id, offset, limit) and inline async handler. The handler validates limit, makes a GET request to Anytype API `/spaces/${space_id}/types` with pagination params, and returns JSON-stringified response data as text content. Errors are handled via handleApiError.
this.server.tool( "get_types", "Retrieves all object types available in a specified Anytype space. This tool provides information about the different types of objects that can be created in the space, including their IDs, names, and metadata. Results are paginated for spaces with many types. Use this tool when you need to understand what types of objects can be created or to find the correct type ID for creating new objects.", { space_id: z.string().describe("Space ID to get types from"), offset: z.number().optional().default(0).describe("Pagination offset"), limit: z .number() .optional() .default(100) .describe("Number of results per page (1-100)"), }, 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}/types`, null, { offset, limit: validLimit } ); return { content: [ { type: "text" as const, text: JSON.stringify(response.data, null, 2), }, ], }; } catch (error) { return this.handleApiError(error); } } );