airtable_get_base_schema

Pack: airtable · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

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

NameTypeRequiredDescription
_apiKeystringyesAirtable personal access token
baseIdstringyesAirtable 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

FieldTypeDescription
tablesarrayList 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 — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}
Connect to just the airtable pack
{
  "mcpServers": {
    "airtable": {
      "url": "https://gateway.pipeworx.io/airtable/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build October 30, 2026