QuickBase MCP Server

Instructions

Implementation Reference

• src/quickbase/client.ts:500-508 (handler)

  Core handler function in QuickBaseClient that executes the QuickBase API call to run the specified report and returns the report data.

  async runReport(reportId: string, tableId: string): Promise<any[]> {
    const response = await this.axios.post('/records/query', {
      from: tableId,
      options: {
        reportId
      }
    });
    return response.data.data;
  }

• src/index.ts:378-394 (handler)

  MCP server handler that dispatches the tool call to the QuickBaseClient.runReport method and formats the response.

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

• src/tools/index.ts:406-416 (schema)

  Tool schema definition including input schema for parameters reportId and tableId, used for registration and validation.

    name: 'quickbase_run_report',
    description: 'Run a specific report',
    inputSchema: {
      type: 'object',
      properties: {
        reportId: { type: 'string', description: 'Report ID' },
        tableId: { type: 'string', description: 'Table ID' }
      },
      required: ['reportId', 'tableId']
    }
  },

• src/index.ts:51-52 (registration)

  Registration of all QuickBase tools including quickbase_run_report via the listTools handler.

  return {
    tools: quickbaseTools,