`airtable_get_base_schema`

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

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

Name	Type	Required	Description
`_apiKey`	string	yes	Airtable personal access token
`baseId`	string	yes	Airtable base ID

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

Field	Type	Description
`tables`	array	List of tables in the base

Full JSON Schema

{
  "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.

airtable_get_base_schema