airtable_get_base_schema

Pack: airtable · Endpoint: https://gateway.pipeworx.io/airtable/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/airtable_get_base_schema for the schema, then POST the same URL with its arguments for the data.

Get the structure of an Airtable base—all tables, field names, field types, and configurations. Use first to understand available data before querying or creating records.

Parameters

Example call

Arguments

{
  "_apiKey": "your-airtable-api-key",
  "baseId": "appXXXXXXXXXXXX"
}

curl

curl -X POST https://gateway.pipeworx.io/airtable/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"airtable_get_base_schema","arguments":{"_apiKey":"your-airtable-api-key","baseId":"appXXXXXXXXXXXX"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('airtable_get_base_schema', {
  "_apiKey": "your-airtable-api-key",
  "baseId": "appXXXXXXXXXXXX"
});

Response shape

Always returns: tables

{
  "type": "object",
  "properties": {
    "tables": {
      "type": "array",
      "description": "List of tables in the base",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Table ID"
          },
          "name": {
            "type": "string",
            "description": "Table name"
          },
          "fields": {
            "type": "array",
            "description": "Fields defined in this table",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Field ID"
                },
                "name": {
                  "type": "string",
                  "description": "Field name"
                },
                "type": {
                  "type": "string",
                  "description": "Field type (e.g., singleLineText, number, checkbox)"
                }
              }
            }
          }
        }
      }
    }
  },
  "required": [
    "tables"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "airtable": {
      "url": "https://gateway.pipeworx.io/airtable/mcp"
    }
  }
}

See Getting Started for client-specific install steps.