MCP

MCP tools call the same actions as HTTP. One call uses one drive. A tool returns the list itself.

MCP tools are the same operations as the HTTP routes, bound to the credential. A tool does not invent a second permission check. A hidden object is not found, and a hidden file is not opened for search or SQL. How to instruct a model is on Ask an agent. The endpoint is https://api.contextdrive.io/mcp.

A tool that takes an organization id must name the caller’s organization. list_drives may omit it and then lists this caller’s drives. Drive tools take the drive id. One call uses one drive. A tool does not accept a second organization for the bytes.

HTTP lists return { "items", "limit", "offset", "total" }. An MCP tool returns the list itself. list_audit returns that page, because the log is paged before the tool returns. Each row has driveId, objectKind, and objectName copied when the decision was recorded.

The groups match the HTTP tables.

GroupTools
Caller and organizationme, list_organizations, get_organization, list_members
Tag typeslist_tag_types, create_tag_type, update_tag_type, retire_tag_type, list_membership_tags, replace_membership_tags
Driveslist_drives, get_drive, create_shared_drive, list_shared_drives, list_audit, add_drive_member, remove_drive_member
Directoriesget_root_directory, list_directories, list_directory_content, get_directory, create_directory, update_directory, delete_directory, set_directory_deletion_protection, list_directory_members, replace_directory_members
Directory tagslist_directory_tags, apply_directory_tag, remove_directory_tag, set_directory_tag_match
Fileslist_files, get_file, create_file, commit_file, download_file, delete_file, expand_file, commit_upload, get_upload, delete_upload, set_file_deletion_protection
File tagslist_file_tags, apply_file_tag, remove_file_tag, set_file_tag_match
Noteslist_file_notes, create_file_note, list_directory_notes, create_directory_note, get_note, update_note, delete_note, create_note_attachment, commit_note_attachment, download_note_attachment, delete_note_attachment
Catalogsearch, query, draft_query, list_queries, create_query, get_query, update_query, delete_query, run_query
Shortcutslist_shortcuts, create_shortcut, get_shortcut, delete_shortcut

create_file is the upload grant. The bytes go to the grant, not to the tool. create_note_attachment is the same kind of grant for an image or a PDF on a note. expand_file expands a ready zip and leaves the zip in place. query, draft_query, and run_query return the same page as the HTTP query. How to name the relations and write the statement is on SQL. draft_query also returns the statement. search returns cited passages from the files and directory notes this caller can see. get_note includes attachments. A list of notes returns the notes themselves.

Empty optional arguments mean “leave this unset”: an empty directory id on list_directories lists the root’s children, and an empty sort is name.