USE WHEN you need a quick inventory of all collections before querying or writing.

EXAMPLES:

• "What collections exist?" -> describe_schema()

• "Does a 'posts' collection exist?" -> describe_schema()

• After adding a collection -> describe_schema(refresh=True)

NEXT STEPS: describe_collection(collection="") for field details.

USE WHEN you need full field definitions, API rules, or relation targets for one collection.

EXAMPLES:

• "What fields does 'posts' have?" -> describe_collection(collection="posts")

• Before write_record to see required fields -> describe_collection(collection="posts")

• "What are the auth rules?" -> describe_collection(collection="users")

NEXT STEPS: find_records or write_record with the correct field names.

USE WHEN you need to query or look up records in a collection.

EXAMPLES:

• By id: find_records(collection="posts", record_id="abc123")

• By filter: find_records(collection="posts", filter_template="status = {:s}", filter_params={"s": "published"})

• All records: find_records(collection="posts", fetch_all=True)

NEXT STEPS: write_record to mutate, describe_collection for field names.

USE WHEN you need to create or update a single record.

EXAMPLES:

• Create: write_record(collection="posts", action="create", data={"title": "Hi", "body": "..."})

• Update: write_record(collection="posts", action="update", record_id="abc", data={"title": "New"})

NEXT STEPS: find_records to verify, describe_collection for field names.

USE WHEN you need to create/update/delete multiple records atomically.

EXAMPLES:

• operations=[ {"collection": "posts", "action": "create", "data": {"title": "A"}}, {"collection": "posts", "action": "update", "record_id": "xyz", "data": {"title": "B"}}, ]

NEXT STEPS: find_records to verify results.

USE WHEN you need to create or modify a collection schema.

EXAMPLES:

• Create base: manage_collection(action="create", name="posts", fields=[{"name": "title", "type": "text", "required": True}])

• Create view: manage_collection(action="create", name="post_stats", collection_type="view", view_query="SELECT id, title FROM posts")

• Update rules: manage_collection(action="update", name="posts", api_rules={"list": "@request.auth.id != ''"})

NEXT STEPS: describe_collection to verify, find_records or write_record to use.

USE WHEN you need to authenticate or check the current session identity.

EXAMPLES:

• Check identity: connect(as_="status")

• Superuser: connect(as_="superuser", email="admin@x.com", password="...")

• User: connect(as_="user", collection="users", email="u@x.com", password="...")

• Impersonate: connect(as_="impersonate", user_id="abc123")

NEXT STEPS: All subsequent tool calls in this session use the new identity.

USE WHEN you need to manage auth lifecycle: password reset, verification, email change, or token refresh.

EXAMPLES:

• Request reset: manage_auth(action="request_password_reset", collection="users", email="u@x.com")

• Confirm reset: manage_auth(action="confirm_password_reset", collection="users", token="...", password="new", password_confirm="new")

• Refresh token: manage_auth(action="refresh", collection="users")

NEXT STEPS: connect(as_='status') to verify identity after refresh.

USE WHEN you need to get a file URL, download a file, or upload a new file to a record.

EXAMPLES:

• URL: manage_files(action="url", collection="posts", record_id="abc", field="cover", filename="img.jpg")

• Thumb: manage_files(action="url", ..., thumb="200x200")

• Download: manage_files(action="download", ..., filename="doc.pdf")

• Upload: manage_files(action="upload", ..., field="cover", local_path="/tmp/img.jpg", filename="img.jpg")

NEXT STEPS: find_records to see the updated file field after upload.

USE WHEN you need an overview of server health, settings, cron jobs, and log statistics.

EXAMPLES:

• "Is PocketBase running?" -> inspect_server()

• "What cron jobs are registered?" -> inspect_server()

• "How many requests in the last 7 days?" -> inspect_server()

NEXT STEPS: read_logs for detailed log entries; connect(as_='superuser') for full access.

USE WHEN you need to inspect request log entries. Superuser access required.

EXAMPLES:

• Latest logs: read_logs()

• Single entry: read_logs(log_id="xyz")

• Filter by level: read_logs(filter_template="level >= {:l}", filter_params={"l": 4})

NEXT STEPS: inspect_server for aggregate stats; connect(as_='superuser') if unauthorized.