QuickBase MCP Server

Instructions

Implementation Reference

• src/quickbase/client.ts:91-96 (handler)

  The core handler function that executes the tool logic by making an API request to QuickBase to retrieve all fields for the given table ID.

  async getTableFields(tableId: string): Promise<any[]> {
    const response = await this.axios.get(`/fields`, {
      params: { tableId }
    });
    return response.data;
  }

• src/tools/index.ts:174-184 (schema)

  Defines the tool's metadata including name, description, and input schema validation (requiring tableId string).

  {
    name: 'quickbase_get_table_fields',
    description: 'Get all fields for a table',
    inputSchema: {
      type: 'object',
      properties: {
        tableId: { type: 'string', description: 'QuickBase table ID' }
      },
      required: ['tableId']
    }
  },

• src/index.ts:140-151 (registration)

  Registers the tool handler in the MCP server's switch statement, dispatching calls to the QuickBaseClient.getTableFields method.

  case 'quickbase_get_table_fields':
    if (!args || typeof args !== 'object') {
      throw new Error('Invalid arguments');
    }
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(await this.qbClient.getTableFields(args.tableId as string), null, 2),
        },
      ],
    };

• src/index.ts:49-54 (registration)

  Registers the list tools handler which returns the quickbaseTools array containing this tool's schema.

  // List available tools
  this.server.setRequestHandler(ListToolsRequestSchema, async () => {
    return {
      tools: quickbaseTools,
    };
  });