getSpaces
Retrieve a list of Snapshot spaces to view governance platforms, with options to limit results or skip entries for efficient browsing.
Instructions
Get list of Snapshot spaces
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "getSpaces"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of spaces to fetch | |
| skip | No | Number of spaces to skip |
Implementation Reference
- src/services/snapshotService.ts:195-221 (handler)Core handler function that performs the GraphQL query to fetch paginated list of Snapshot spaces.
async getSpaces(first: number = 20, skip: number = 0): Promise<Space[]> { const query = ` query Spaces { spaces( first: ${first}, skip: ${skip}, orderBy: "created", orderDirection: asc ) { id name about network symbol strategies { name params } admins members } } `; const result = await this.queryGraphQL(query); return result.spaces; } - src/server.ts:17-20 (schema)Zod schema for validating input parameters (limit, skip) for the getSpaces tool.
const SpacesParamsSchema = z.object({ limit: z.number().optional(), skip: z.number().optional() }); - src/server.ts:69-79 (registration)Tool registration in the listTools handler, defining name, description, and inputSchema.
{ name: "getSpaces", description: "Get list of Snapshot spaces", inputSchema: { // Changed from parameters to inputSchema type: "object", properties: { limit: { type: "number", description: "Number of spaces to fetch" }, skip: { type: "number", description: "Number of spaces to skip" } } } }, - src/server.ts:145-157 (handler)MCP tool call dispatch handler that validates args, calls the service, and formats response.
case "getSpaces": { const parsedArgs = SpacesParamsSchema.parse(args); const spaces = await this.snapshotService.getSpaces( parsedArgs.limit || 20, parsedArgs.skip || 0 ); return { content: [{ type: "text", text: JSON.stringify(spaces, null, 2) }] }; } - TypeScript interface defining the structure of a Space object returned by getSpaces.
interface Space { id: string; name: string; about?: string; network?: string; symbol?: string; strategies?: any[]; admins?: string[]; members?: string[]; }