My dad told me to get an apartment that was built the same year Spain won its first World Cup. Check the cloud data and tell me if there are any premium one-bedroom units with the best available energy rating built that year. If there are, please provide me with the monthly rent for it.
Open in GymMy dad told me to get an apartment that was built the same year Spain won its first World Cup. Check the cloud data and tell me if there are any premium one-bedroom units with the best available energy rating built that year. If there are, please provide me with the monthly rent for it.
---
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 |
|---|---|
| `/data` | Your files. |
| `/notion` | Your Notion workspace, 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]`| 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 |
|---|---|
/data | Your files. |
/notion | Your Notion workspace, 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]---
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 |
## 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"}'
oxylabs amazon-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. |
| `oxylabs amazon-search-scraper` | `{query: str, category_id?: str = "", merchant_id?: str = "", currency?: 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, domain?: str = "", geo_location?: str = "", locale?: str = "", output_format?: "" \| "links" \| "md" \| "html" = ""}` | Scrape Amazon search results. |
## fetch
Use `fetch <command> '<JSON arguments>'`. Run `fetch <command> --help` to
get more information.
```sh
fetch fetch '{"url":"https://example.com"}'
```
| Command | Arguments | Description |
|---|---|---|
| `fetch fetch` | `{url: str, max_length?: int = 5000, start_index?: int = 0, raw?: bool = false}` | Fetches a URL from the internet and optionally extracts its contents as markdown. |
## mcp-server-code-runner
Use `mcp-server-code-runner <command> '<JSON arguments>'`. Run
`mcp-server-code-runner <command> --help` to get more information.
```sh
mcp-server-code-runner run-code '{"code":"print(1 + 1)","languageId":"python"}'
```
| Command | Arguments | Description |
|---|---|---|
| `mcp-server-code-runner run-code` | `{code: str, languageId: "javascript" \| "php" \| "python" \| "perl" \| "perl6" \| "ruby" \| "go" \| "lua" \| "groovy" \| "powershell" \| "bat" \| "shellscript" \| "fsharp" \| "csharp" \| "vbscript" \| "typescript" \| "coffeescript" \| "scala" \| "swift" \| "julia" \| "crystal" \| "ocaml" \| "r" \| "applescript" \| "clojure" \| "racket" \| "scheme" \| "ahk" \| "autoit" \| "dart" \| "haskell" \| "nim" \| "lisp" \| "kit" \| "v" \| "sass" \| "scss"}` | Run code snippet and return the result. || 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 |
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"}'
oxylabs amazon-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. |
oxylabs amazon-search-scraper | `{query: str, category_id?: str = "", merchant_id?: str = "", currency?: 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, domain?: str = "", geo_location?: str = "", locale?: str = "", output_format?: "" \ | "links" \ | "md" \ | "html" = ""}` | Scrape Amazon search results. |
fetch
Use fetch <command> '<JSON arguments>'. Run fetch <command> --help to get more information.
fetch fetch '{"url":"https://example.com"}'| Command | Arguments | Description |
|---|---|---|
fetch fetch | {url: str, max_length?: int = 5000, start_index?: int = 0, raw?: bool = false} | Fetches a URL from the internet and optionally extracts its contents as markdown. |
mcp-server-code-runner
Use mcp-server-code-runner <command> '<JSON arguments>'. Run mcp-server-code-runner <command> --help to get more information.
mcp-server-code-runner run-code '{"code":"print(1 + 1)","languageId":"python"}'| Command | Arguments | Description | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
mcp-server-code-runner run-code | `{code: str, languageId: "javascript" \ | "php" \ | "python" \ | "perl" \ | "perl6" \ | "ruby" \ | "go" \ | "lua" \ | "groovy" \ | "powershell" \ | "bat" \ | "shellscript" \ | "fsharp" \ | "csharp" \ | "vbscript" \ | "typescript" \ | "coffeescript" \ | "scala" \ | "swift" \ | "julia" \ | "crystal" \ | "ocaml" \ | "r" \ | "applescript" \ | "clojure" \ | "racket" \ | "scheme" \ | "ahk" \ | "autoit" \ | "dart" \ | "haskell" \ | "nim" \ | "lisp" \ | "kit" \ | "v" \ | "sass" \ | "scss"}` | Run code snippet and return the result. |
| Model | VFS | MCP | VFS Tokens | MCP Tokens | Token Reduction Rate |
|---|---|---|---|---|---|
| Claude Opus 5.5 | 1/1 | 1/1 | 36.6k | 67.8k | 46% |
| GPT-6.1 Sol | 1/1 | 0/1 | 20.1k | 242k | 92% |
| GPT-5.6 Luna | 1/1 | 1/1 | 40.2k | 59.3k | 32% |
| Claude Haiku 5.5 | 0/1 | 0/1 | 106k | 742k | 86% |
| Gemini 3.8 Flash | 1/1 | 0/1 | 240k | 1.48M | 84% |