I'm thinking of going apartment hunting. I have this idea that the apartments built years before the year Hurricane Katrina happened are a good investment, so check my database for any premium 2-bedroom apartment with a one-year lease built before that. I'm on a tight budget, so only give me the apartment numbers of the apartments with a monthly rent of less than 2500 USD and a deposit of less than 1000 USD.
I'm thinking of going apartment hunting. I have this idea that the apartments built years before the year Hurricane Katrina happened are a good investment, so check my database for any premium 2-bedroom apartment with a one-year lease built before that. I'm on a tight budget, so only give me the apartment numbers of the apartments with a monthly rent of less than 2500 USD and a deposit of less than 1000 USD.
---
name: workspace-filesystem
description: The virtual filesystem layout of this workspace.
---
# Virtual Filesystem
You work in a terminal over a virtual filesystem. Read files with shell
commands.
Command output comes back whole, however long. Some files here are large,
so point `grep -r`, `rg`, `find` and `cat` at the directory or file you
need rather than at a whole mount.
| path | what it is |
|---|---|
| `/notion` | Your Notion workspace, read-only. |
| `/calendar` | Your Google Calendar, read-only. |
| `/tmp` | Scratch space, in memory. |
## `/notion`
```
/notion/
pages/
<page-title>__<page-id>/
page.json
<child-page-title>__<child-id>/
page.json
databases/
<database-title>__<database-id>/
database.json
<data-source-title>__<data-source-id>/
data_source.json
rows.jsonl
```
A title in a path is sanitized: spaces and characters unsafe in a shell
become `_`. `ls` the parent directory for the exact name, or take a row's
`path` from `rows.jsonl`.
- `database.json`: `{database_id: str, title: str, url: str | null,
created_time: str | null, last_edited_time: str | null, parent: dict,
archived: bool, is_inline: bool, data_sources: list[{id: str, name: str}]}`
- `data_source.json`: `{data_source_id: str, database_id: str, title: str,
created_time: str | null, last_edited_time: str | null, database_parent:
dict, archived: bool, properties: {<column>: {id: str, name: str, type:
str, <type>: dict}}}`
- `rows.jsonl`: one row per line, `{page_id: str, title: str, path: str,
url: str, created_time: str, last_edited_time: str, parent_type: str,
parent_id: str, archived: bool, created_by: str, last_edited_by: str,
properties: {<column>: {id: str, type: str, <type>: <value>}}}`. Row
directories are not listed; a row's `page.json` is at its `path` below the
data source directory. A table's `rows.jsonl` can run to several
megabytes.
- `page.json`: a row's fields less `path`, plus `markdown: str`, the body,
and `blocks: list[dict]`
## `/calendar`
```
/calendar/
primary/
calendar.json
<yyyy-mm-dd>/
<event-id>__<HHMM-HHMM>_<Title>.gcal.json
```
- `calendar.json`: `{id: str, summary: str, accessRole: str, primary: bool,
calendarTimeZone: str, bucketTimeZone: str}`
- `<event>.gcal.json`: the Calendar API's event, `{kind: str, id: str,
status: str, summary: str, description?: str, location?: str, start:
{dateTime: str, timeZone: str}, end: {dateTime: str, timeZone: str},
created: str, updated: str, iCalUID: str, htmlLink: str}`
Days are cut in `bucketTimeZone`. Listing `/calendar/primary`, with `ls` or
`find`, shows every day with an event up to 90 days after today; read a later
day by its date, as in `ls /calendar/primary/2027-03-*`.| name | workspace-filesystem |
|---|---|
| description | The virtual filesystem layout of this workspace. |
Virtual Filesystem
You work in a terminal over a virtual filesystem. Read files with shell commands.
Command output comes back whole, however long. Some files here are large, so point grep -r, rg, find and cat at the directory or file you need rather than at a whole mount.
| path | what it is |
|---|---|
/notion | Your Notion workspace, read-only. |
/calendar | Your Google Calendar, read-only. |
/tmp | Scratch space, in memory. |
/notion
/notion/
pages/
<page-title>__<page-id>/
page.json
<child-page-title>__<child-id>/
page.json
databases/
<database-title>__<database-id>/
database.json
<data-source-title>__<data-source-id>/
data_source.json
rows.jsonlA title in a path is sanitized: spaces and characters unsafe in a shell become _. ls the parent directory for the exact name, or take a row's path from rows.jsonl.
database.json: {database_id: str, title: str, url: str | null, created_time: str | null, last_edited_time: str | null, parent: dict, archived: bool, is_inline: bool, data_sources: list[{id: str, name: str}]}data_source.json: {data_source_id: str, database_id: str, title: str, created_time: str | null, last_edited_time: str | null, database_parent: dict, archived: bool, properties: {<column>: {id: str, name: str, type: str, <type>: dict}}}rows.jsonl: one row per line, {page_id: str, title: str, path: str, url: str, created_time: str, last_edited_time: str, parent_type: str, parent_id: str, archived: bool, created_by: str, last_edited_by: str, properties: {<column>: {id: str, type: str, <type>: <value>}}}. Row directories are not listed; a row's page.json is at its path below the data source directory. A table's rows.jsonl can run to several megabytes.page.json: a row's fields less path, plus markdown: str, the body, and blocks: list[dict]/calendar
/calendar/
primary/
calendar.json
<yyyy-mm-dd>/
<event-id>__<HHMM-HHMM>_<Title>.gcal.jsoncalendar.json: {id: str, summary: str, accessRole: str, primary: bool, calendarTimeZone: str, bucketTimeZone: str}<event>.gcal.json: the Calendar API's event, {kind: str, id: str, status: str, summary: str, description?: str, location?: str, start: {dateTime: str, timeZone: str}, end: {dateTime: str, timeZone: str}, created: str, updated: str, iCalUID: str, htmlLink: str}Days are cut in bucketTimeZone. Listing /calendar/primary, with ls or find, shows every day with an event up to 90 days after today; read a later day by its date, as in ls /calendar/primary/2027-03-*.
---
name: workspace-commands
description: Use when running commands in this workspace - which commands exist, what they can do, and what the interpreter supports.
---
# Available commands
Python (`python` or `python3`), Perl, JavaScript/Node.js, and TypeScript
runtimes are unavailable. Use the shell commands and task CLIs documented
below; do not probe for or attempt to install other runtimes.
Standard Unix commands, among them:
cat head tail ls find grep wc sort uniq cut tr sed awk
diff tee xargs jq
with pipes, `>` redirection and `$(...)` substitution.
Do not probe the machine with `which`, `type`, `--version`, `env`, `ps`,
`echo $PATH`, `ls /usr/bin` or `cat /usr/bin/<command>`: they tell you
nothing about the task.
A filename with a space in it needs quoting, as it would in any shell.
## notion
Use `notion <command> '<JSON arguments>'`. Run `notion <command> --help` to
get more information.
```sh
notion get-user '{"user_id":"ID"}'
notion get-users '{}'
notion get-self '{}'
notion post-database-query '{"database_id":"ID","filter":{"property":"Name","rich_text":{"contains":"TEXT"}},"page_size":10}'
notion post-search '{"query":"QUERY"}'
notion get-block-children '{"block_id":"ID"}'
notion retrieve-a-block '{"block_id":"ID"}'
notion retrieve-a-page '{"page_id":"ID"}'
notion retrieve-a-database '{"database_id":"ID"}'
notion retrieve-a-page-property '{"page_id":"ID","property_id":"PROPERTY_ID"}'
notion retrieve-a-comment '{"block_id":"ID"}'
```
| Command | Arguments | Description |
|---|---|---|
| `notion get-user` | `{user_id: str}` | Retrieve a user Error Responses: 400: 400 |
| `notion get-users` | `{start_cursor?: str, page_size?: int = 100}` | List all users Error Responses: 400: 400 |
| `notion get-self` | `{}` | Retrieve your token's bot user |
| `notion post-database-query` | `{database_id: str, filter_properties?: list[str], filter?: dict, sorts?: list[{property: str, direction: "ascending" \| "descending"}], start_cursor?: str, page_size?: int = 100, archived?: bool, in_trash?: bool}` | Query a database |
| `notion post-search` | `{query?: str, sort?: {direction?: str, timestamp?: str}, filter?: {value?: str, property?: str}, start_cursor?: str, page_size?: int = 100}` | Search by title |
| `notion get-block-children` | `{block_id: str, start_cursor?: str, page_size?: int = 100}` | Retrieve block children |
| `notion retrieve-a-block` | `{block_id: str}` | Retrieve a block |
| `notion retrieve-a-page` | `{page_id: str, filter_properties?: str}` | Retrieve a page |
| `notion retrieve-a-database` | `{database_id: str}` | Retrieve a database |
| `notion retrieve-a-page-property` | `{page_id: str, property_id: str, page_size?: int, start_cursor?: str}` | Retrieve a page property item |
| `notion retrieve-a-comment` | `{block_id: str, start_cursor?: str, page_size?: int}` | Retrieve comments |
## google-workspace
Use `google-workspace <command> '<JSON arguments>'`. Run
`google-workspace <command> --help` to get more information.
```sh
google-workspace list-events '{"timeMin":"YYYY-MM-DDT00:00:00Z","timeMax":"YYYY-MM-DDT00:00:00Z","maxResults":50}'
```
| Command | Arguments | Description |
|---|---|---|
| `google-workspace list-events` | `{maxResults?: number, timeMin?: str, timeMax?: str}` | List upcoming calendar events |
## oxylabs
Use `oxylabs <command> '<JSON arguments>'`. Run `oxylabs <command> --help`
to get more information.
```sh
oxylabs universal-scraper '{"url":"https://example.com","output_format":"md"}'
oxylabs google-search-scraper '{"query":"QUERY"}'
```
| Command | Arguments | Description |
|---|---|---|
| `oxylabs universal-scraper` | `{url: str, render?: "" \| "html" = "", user_agent_type?: "" \| "desktop" \| "desktop_chrome" \| "desktop_firefox" \| "desktop_safari" \| "desktop_edge" \| "desktop_opera" \| "mobile" \| "mobile_ios" \| "mobile_android" \| "tablet" = "", geo_location?: str = "", output_format?: "" \| "links" \| "md" \| "html" = ""}` | Get a content of any webpage. |
| `oxylabs google-search-scraper` | `{query: str, parse?: bool = true, render?: "" \| "html" = "", user_agent_type?: "" \| "desktop" \| "desktop_chrome" \| "desktop_firefox" \| "desktop_safari" \| "desktop_edge" \| "desktop_opera" \| "mobile" \| "mobile_ios" \| "mobile_android" \| "tablet" = "", start_page?: int = 0, pages?: int = 0, limit?: int = 0, domain?: str = "", geo_location?: str = "", locale?: str = "", ad_mode?: bool = false, output_format?: "" \| "links" \| "md" \| "html" = ""}` | Scrape Google Search results. |
## calculator
Use `calculator <command> '<JSON arguments>'`. Run
`calculator <command> --help` to get more information.
```sh
calculator calculate '{"expression":"2 * (3 + 4)"}'
```
| Command | Arguments | Description |
|---|---|---|
| `calculator calculate` | `{expression: str}` | Calculates/evaluates the given expression. || name | workspace-commands |
|---|---|
| description | Use when running commands in this workspace - which commands exist, what they can do, and what the interpreter supports. |
Available commands
Python (python or python3), Perl, JavaScript/Node.js, and TypeScript runtimes are unavailable. Use the shell commands and task CLIs documented below; do not probe for or attempt to install other runtimes.
Standard Unix commands, among them:
cat head tail ls find grep wc sort uniq cut tr sed awk
diff tee xargs jqwith pipes, > redirection and $(...) substitution.
Do not probe the machine with which, type, --version, env, ps, echo $PATH, ls /usr/bin or cat /usr/bin/<command>: they tell you nothing about the task.
A filename with a space in it needs quoting, as it would in any shell.
notion
Use notion <command> '<JSON arguments>'. Run notion <command> --help to get more information.
notion get-user '{"user_id":"ID"}'
notion get-users '{}'
notion get-self '{}'
notion post-database-query '{"database_id":"ID","filter":{"property":"Name","rich_text":{"contains":"TEXT"}},"page_size":10}'
notion post-search '{"query":"QUERY"}'
notion get-block-children '{"block_id":"ID"}'
notion retrieve-a-block '{"block_id":"ID"}'
notion retrieve-a-page '{"page_id":"ID"}'
notion retrieve-a-database '{"database_id":"ID"}'
notion retrieve-a-page-property '{"page_id":"ID","property_id":"PROPERTY_ID"}'
notion retrieve-a-comment '{"block_id":"ID"}'| Command | Arguments | Description | |
|---|---|---|---|
notion get-user | {user_id: str} | Retrieve a user Error Responses: 400: 400 | |
notion get-users | {start_cursor?: str, page_size?: int = 100} | List all users Error Responses: 400: 400 | |
notion get-self | {} | Retrieve your token's bot user | |
notion post-database-query | `{database_id: str, filter_properties?: list[str], filter?: dict, sorts?: list[{property: str, direction: "ascending" \ | "descending"}], start_cursor?: str, page_size?: int = 100, archived?: bool, in_trash?: bool}` | Query a database |
notion post-search | {query?: str, sort?: {direction?: str, timestamp?: str}, filter?: {value?: str, property?: str}, start_cursor?: str, page_size?: int = 100} | Search by title | |
notion get-block-children | {block_id: str, start_cursor?: str, page_size?: int = 100} | Retrieve block children | |
notion retrieve-a-block | {block_id: str} | Retrieve a block | |
notion retrieve-a-page | {page_id: str, filter_properties?: str} | Retrieve a page | |
notion retrieve-a-database | {database_id: str} | Retrieve a database | |
notion retrieve-a-page-property | {page_id: str, property_id: str, page_size?: int, start_cursor?: str} | Retrieve a page property item | |
notion retrieve-a-comment | {block_id: str, start_cursor?: str, page_size?: int} | Retrieve comments |
google-workspace
Use google-workspace <command> '<JSON arguments>'. Run google-workspace <command> --help to get more information.
google-workspace list-events '{"timeMin":"YYYY-MM-DDT00:00:00Z","timeMax":"YYYY-MM-DDT00:00:00Z","maxResults":50}'| Command | Arguments | Description |
|---|---|---|
google-workspace list-events | {maxResults?: number, timeMin?: str, timeMax?: str} | List upcoming calendar events |
oxylabs
Use oxylabs <command> '<JSON arguments>'. Run oxylabs <command> --help to get more information.
oxylabs universal-scraper '{"url":"https://example.com","output_format":"md"}'
oxylabs google-search-scraper '{"query":"QUERY"}'| Command | Arguments | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
oxylabs universal-scraper | `{url: str, render?: "" \ | "html" = "", user_agent_type?: "" \ | "desktop" \ | "desktop_chrome" \ | "desktop_firefox" \ | "desktop_safari" \ | "desktop_edge" \ | "desktop_opera" \ | "mobile" \ | "mobile_ios" \ | "mobile_android" \ | "tablet" = "", geo_location?: str = "", output_format?: "" \ | "links" \ | "md" \ | "html" = ""}` | Get a content of any webpage. |
oxylabs google-search-scraper | `{query: str, parse?: bool = true, render?: "" \ | "html" = "", user_agent_type?: "" \ | "desktop" \ | "desktop_chrome" \ | "desktop_firefox" \ | "desktop_safari" \ | "desktop_edge" \ | "desktop_opera" \ | "mobile" \ | "mobile_ios" \ | "mobile_android" \ | "tablet" = "", start_page?: int = 0, pages?: int = 0, limit?: int = 0, domain?: str = "", geo_location?: str = "", locale?: str = "", ad_mode?: bool = false, output_format?: "" \ | "links" \ | "md" \ | "html" = ""}` | Scrape Google Search results. |
calculator
Use calculator <command> '<JSON arguments>'. Run calculator <command> --help to get more information.
calculator calculate '{"expression":"2 * (3 + 4)"}'| Command | Arguments | Description |
|---|---|---|
calculator calculate | {expression: str} | Calculates/evaluates the given expression. |
| Model | VFS | MCP | VFS Tokens | MCP Tokens | Token Reduction Rate |
|---|---|---|---|---|---|
| Claude Opus 5.5 | 1/1 | 1/1 | 22.1k | 48.4k | 54% |
| GPT-6.1 Sol | 0/1 | 0/1 | 28.5k | 22.6k | −26% |
| GPT-5.6 Luna | 0/1 | 0/1 | 26.5k | 26.0k | −2% |
| Claude Haiku 5.5 | 0/1 | 0/1 | 99.0k | 52.2k | −90% |
| Gemini 3.8 Flash | 1/1 | 1/1 | 280k | 546k | 49% |