PocketBase MCP Server

Instructions

Implementation Reference

• src/index.ts:936-959 (handler)

  The core handler function for the 'get_collection' tool. It authenticates as admin using PocketBase superuser credentials, retrieves the specified collection details (optionally selecting fields), and returns the JSON-stringified collection data as MCP content.

  private async getCollection(args: any) {
    try {
      // Authenticate with PocketBase
      await this.pb.collection("_superusers").authWithPassword(process.env.POCKETBASE_ADMIN_EMAIL ?? '', process.env.POCKETBASE_ADMIN_PASSWORD ?? '');
      
      // Get collection details
      const collection = await this.pb.collections.getOne(args.collectionIdOrName, {
        fields: args.fields
      });
      
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(collection, null, 2),
          },
        ],
      };
    } catch (error: unknown) {
      throw new McpError(
        ErrorCode.InternalError,
        `Failed to get collection: ${pocketbaseErrorMessage(error)}`
      );
    }

• src/index.ts:577-594 (registration)

  Tool registration in the list passed to server.setTools(). Defines the tool name, description, and input schema.

  {
    name: 'get_collection',
    description: 'Get details for a collection',
    inputSchema: {
      type: 'object',
      properties: {
        collectionIdOrName: {
          type: 'string',
          description: 'ID or name of the collection to view',
        },
        fields: {
          type: 'string',
          description: 'Comma separated string of the fields to return in the JSON response',
        },
      },
      required: ['collectionIdOrName'],
    },
  },

• src/index.ts:580-593 (schema)

  Input schema definition for the 'get_collection' tool, specifying parameters like collectionIdOrName (required) and optional fields.

  inputSchema: {
    type: 'object',
    properties: {
      collectionIdOrName: {
        type: 'string',
        description: 'ID or name of the collection to view',
      },
      fields: {
        type: 'string',
        description: 'Comma separated string of the fields to return in the JSON response',
      },
    },
    required: ['collectionIdOrName'],
  },

• src/index.ts:687-688 (registration)

  Dispatch case in the CallToolRequest handler that routes 'get_collection' calls to the specific getCollection method.

  case 'get_collection':
    return await this.getCollection(request.params.arguments);