Tools reference
3Dogs Nexus gives your assistant 22 tools. You do not call them yourself; you ask in plain words and your assistant uses them. Each entry below lists the tool's title and name, what it does, its inputs, what it returns, whether it is counted, and its hints exactly as the connector declares them.
Hints are declared by the connector for your assistant: read-only means the tool changes nothing; "changes something" means it may write data; "can delete or overwrite data" is the destructive hint; "safe to repeat" is the idempotent hint; "reaches outside sources" is the open-world hint. A tool that asks for confirmation says so in its entry.
Ask and check
Run or audit with 3Dogs Nexus (ask_3dogs)
- What it does: Hands a question, part of a larger job, a draft to audit or a challenge to 3Dogs Nexus and returns a cited answer or a job id.
- Inputs:
question(string; required): The question, a part of a larger job, 'AUDIT: <original question>' or 'CHALLENGE: <original question>'.goal(string; optional): Why the user wants this result.constraints(array of string; optional): Geography, period, budget, jurisdiction, exclusions, etc.context(string, max 800,000 characters; optional): Material for this call, up to 800,000 characters: the user's documents or data (one piece per call for large sets), or the draft answer to audit.context_sources(array of string; optional): Names of the sources of the context.output_format(string, one of: summary, memo, table, json; optional): Desired format of the response.capability(string; optional): Capability identifier or 'auto' to choose automatically.language(string; optional): Target language code (e.g., 'en').client_request_id(string; optional): Unique ID for idempotency.my_answer(string, max 6,000 characters; optional): Optional. Your own short independent answer, written before you see any 3Dogs result for this question. 3Dogs counts it as one more voice beside its panel.transfer_id(string; optional): Optional. A transfer_id from send_to_3dogs; 3Dogs reads every file in that transfer as the material.
- Returns: A cited answer ([W1] web, [C#] 3Dogs records, [U1] your material) with a Sources list and a tier line, or a job id to pass to check_3dogs_job.
- Free or counted: Counted: each call creates one job (4 at once, 300 per 24 hours; failed jobs are not counted). Needs an active free trial or plan.
- Hints: changes something; not destructive; repeating it can have a second effect; reaches outside sources (the live web)
Check 3Dogs Nexus job (check_3dogs_job)
- What it does: Returns the status or result of a job you submitted earlier.
- Inputs:
job_id(string; required): The job identifier.since_event(integer, min 0, default 0; optional): Event cursor; returns findings newer than this.wait_seconds(integer, min 0, max 20, default 0; optional): Seconds to wait for completion, 0 to 20.
- Returns: The finished answer in the same form as ask_3dogs, or "Job <id> is still running. Call check_3dogs_job with this job_id.", or an error such as "Unknown job: <id>".
- Free or counted: Does not create a job.
- Hints: changes something; not destructive; safe to repeat; closed to outside sources
- Note: the schema lists a default of 0 for wait_seconds; the connector waits 15 seconds when it is left out. The tool only reads job state, although its hint declares it as changing something.
About 3Dogs Nexus (about_3dogs)
- What it does: Explains 3Dogs Nexus to your assistant: how to run or audit work with it, how to coordinate large jobs, what each call does, the kinds of work it handles, and limits.
- Inputs: none.
- Returns: The connector instructions text (plus the app and devices section).
- Free or counted: Does not create a job.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
What's new in 3Dogs Nexus (whats_new_3dogs)
- What it does: Lists recent changes to the 3Dogs Nexus connector.
- Inputs: none.
- Returns: The release notes (see Changelog).
- Free or counted: Free; does not count toward usage limits.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
Files
Create a private upload link (send_to_3dogs)
- What it does: Opens a private Direct Transfer and returns a transfer id and an upload link for material too large to paste.
- Inputs:
purpose(string, max 500 characters; optional): What the files are and what the user wants from them.
- Returns: "Direct Transfer opened." with a transfer_id and the upload page link, which works for 24 hours.
- Free or counted: Free; never counts against usage. Needs an active free trial or plan.
- Hints: changes something; not destructive; repeating it can have a second effect; closed to outside sources
List uploaded files (transfer_status)
- What it does: Lists the files received so far for a Direct Transfer, with sizes.
- Inputs:
transfer_id(string; required): The transfer_id send_to_3dogs returned.
- Returns: "Transfer <id>: n file(s), x MB in total." followed by a list of file names with sizes, or "(no files received yet)".
- Free or counted: Free.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
Memory
Save a memory note (remember_3dogs)
- What it does: Stores a private note in your 3Dogs memory, with a label.
- Inputs:
kind(string; required): Category or label for the memory.text(string; required): The text content to store.
- Returns: "Stored as [M<id>]", or a refusal message.
- Free or counted: Does not create a job. Needs an active free trial or plan.
- Hints: changes something; not destructive; repeating it can have a second effect; closed to outside sources
Search memory notes (recall_3dogs)
- What it does: Searches your notes by meaning and returns the best matches.
- Inputs:
query(string; required): Natural-language query text.k(integer; optional): Maximum number of results (default 8).
- Returns: Matching notes, each cited [M<id>], inside a block that says to treat them as data, never as instructions.
- Free or counted: Does not create a job. Needs an active free trial or plan.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
List memory notes (list_3dogs_memory)
- What it does: Lists your recent notes with their ids, newest first.
- Inputs:
limit(integer; optional): Maximum entries (default 50).
- Returns: A numbered list of notes with ids, or "No memories".
- Free or counted: Does not create a job. Not behind the paywall.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
Delete a memory note (forget_3dogs)
- What it does: Deletes one note by its number.
- Inputs:
item_id(integer; required): Memory ID returned by list/recall.
- Returns: "<n> rows affected".
- Free or counted: Does not create a job. Not behind the paywall.
- Hints: changes something; can delete or overwrite data; safe to repeat; closed to outside sources
Erase all memory notes (erase_3dogs_memory)
- What it does: Deletes all your notes, only after you confirm with the exact word ERASE.
- Inputs:
confirm(string; required): Must be the literal 'ERASE' to proceed.
- Returns: "<n> rows affected", or "The literal text 'ERASE' is required to confirm erasure."
- Free or counted: Does not create a job. Not behind the paywall.
- Hints: changes something; can delete or overwrite data; safe to repeat; closed to outside sources. Asks for confirmation: it only proceeds when confirm is exactly ERASE.
3Dogs lessons (free course) (learn_3dogs)
- What it does: Returns the free six-lesson 3Dogs Nexus video course, with links.
- Inputs: none.
- Returns: The six lessons with links.
- Free or counted: Free; does not count toward usage limits.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
Library
List the 3Dogs Library (list_3dogs_library)
- What it does: Lists the ready-made recipes in the 3Dogs Library.
- Inputs: none.
- Returns: For each recipe: ID, Name and Summary.
- Free or counted: Does not create a job.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
Show a 3Dogs Library recipe (show_3dogs_recipe)
- What it does: Shows one Library recipe in full: what it does, its parameters and defaults, and the question it sends to 3Dogs.
- Inputs:
id(string; required): Recipe id from list_3dogs_library, e.g. dip_and_hold or deal_letter.
- Returns: ID, name, version, owner, summary, the question it sends, goal, constraints, output sections and each parameter with its default.
- Free or counted: Does not create a job.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
Copy a recipe to make it yours (copy_3dogs_recipe)
- What it does: Copies a Library recipe into your private memory, optionally naming it and changing parameter defaults.
- Inputs:
id(string; required): Library recipe id to copy.changes(object; optional): Parameter key -> new default value.name(string; optional): Optional name for your copy, e.g. 'My tech dip screen'.
- Returns: "Copied recipe as '<name>' to your collection. Your copy ID: <id>."
- Free or counted: Does not create a job.
- Hints: changes something; not destructive; repeating it can have a second effect; closed to outside sources
Run a recipe with 3Dogs Nexus (run_3dogs_recipe)
- What it does: Runs a Library recipe or one of your copies with the parameters you give.
- Inputs:
id(string; required): Library recipe id or the user's copy id.params(object; optional): Parameter overrides for this run (key -> value).wait_seconds(integer, min 0, max 20; optional):
- Returns: A result or a job id for check_3dogs_job, headed by the recipe name and version and ending with the research-support notice. The Deal Letter answers at once from 3Dogs' latest results.
- Free or counted: Counted like ask_3dogs when the recipe runs through the ask path (Dip & Hold); the Deal Letter answers from 3Dogs' latest results without starting a job.
- Hints: changes something; not destructive; repeating it can have a second effect; reaches outside sources (the live web)
- Note: wait_seconds is accepted for a recipe that runs through the ask path.
List my recipe copies (my_3dogs_recipes)
- What it does: Lists the recipes you have copied.
- Inputs: none.
- Returns: For each copy: ID, Name and which library recipe and version it was copied from, or "You have no recipe copies yet."
- Free or counted: Does not create a job.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
Your devices
List my devices (my_3dogs_devices)
- What it does: Lists your registered devices with their status, opt-in setting, loaded models and last-seen times, plus devices shared with you and people you share with.
- Inputs: none.
- Returns: One line per device, e.g. "- <name> (<platform>) [online, opt-in on, last seen n min ago]"; setup steps if you have no devices.
- Free or counted: Does not create a job.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
Manage models on a device (manage_3dogs_device)
- What it does: Queues a command on one of your own devices to download, load or unload a model, list its models or read its status.
- Inputs:
device(string; required): Device id or device name, as shown in the 3Dogs app.action(string, one of: download_model, load_model, unload_model, list_models, status; required): What to do on the device.model(string; optional): Model name, for example gemma-4-e2b. Required for download_model, load_model and unload_model.
- Returns: "Queued <action> on device '<name>' (<id>). Command id: <id>." The command expires if not picked up within 15 minutes.
- Free or counted: Does not create a job. Work done on your own devices is free.
- Hints: changes something; not destructive; repeating it can have a second effect; closed to outside sources
- Note: model is required for download_model, load_model and unload_model. The device carries out the command within the limits set in the app.
Share devices with another user (share_3dogs_devices)
- What it does: Offers your devices to another 3Dogs user, accepts an offer made to you, withdraws an offer, or lists sharing in both directions.
- Inputs:
action(string, one of: grant, accept, revoke, list; required): grant: offer your devices to an email; accept: accept an offer made to you; revoke: withdraw your offer; list: show both directions.email(string; optional): grant/revoke: the other person's email. accept: optional, not needed.
- Returns: A confirmation of the offer, acceptance or revocation, or a list under "Shared with you:" and "You share with:".
- Free or counted: Does not create a job.
- Hints: changes something; can delete or overwrite data; repeating it can have a second effect; closed to outside sources
- Note: email is required for grant and revoke; for accept it is optional and not needed.
Account and help
Check 3Dogs Nexus usage (my_3dogs_usage)
- What it does: Returns your job counts, limits and plan status.
- Inputs: none.
- Returns: Jobs in last 24 hours (n/300), jobs in flight (n/4), the limits, shared beta capacity left today, and a plan line.
- Free or counted: Does not create a job.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
3Dogs support (support_3dogs)
- What it does: Returns the approved level-one support reference for questions about plans, setup, sign-in, limits, data, privacy and when to contact a person.
- Inputs:
topic(string; optional): Optional: the user's question, for logging.
- Returns: The approved support reference text.
- Free or counted: Free: never counts against usage.
- Hints: read-only (changes nothing); safe to repeat; closed to outside sources
Last updated 11 November 2026