list_bases
Retrieve all accessible Airtable bases to view available workspaces and tables for data management and integration.
Instructions
List all accessible Airtable bases
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_bases"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/airtable_mcp/mcp/server.py:127-140 (handler)The MCP tool handler and registration for 'list_bases'. Decorated with @self.mcp.tool, it retrieves an authenticated AirtableClient and calls its list_bases() method, returning a list of base dictionaries.
@self.mcp.tool(description="List all accessible Airtable bases") async def list_bases() -> list[dict[str, Any]]: """List all accessible Airtable bases.""" client = await self._get_authenticated_client() response = await client.list_bases() return [ { "id": base.id, "name": base.name, "permissionLevel": base.permission_level, } for base in response.bases ] - AirtableClient.list_bases() method, which makes the authenticated GET request to Airtable's /v0/meta/bases endpoint and parses the response using ListBasesResponse model.
async def list_bases(self) -> ListBasesResponse: """List all accessible Airtable bases. Returns: Response containing list of bases """ logger.info("Listing Airtable bases") return await self._make_request( "GET", "/v0/meta/bases", response_model=ListBasesResponse, ) - src/airtable_mcp/api/models.py:8-20 (schema)Pydantic models AirtableBase and ListBasesResponse used for parsing the Airtable API response in list_bases.
class AirtableBase(BaseModel): """Represents an Airtable base.""" id: str name: str permission_level: str = Field(alias="permissionLevel") class ListBasesResponse(BaseModel): """Response from listing Airtable bases.""" bases: list[AirtableBase]