{"tools":[{"description":"Connects a coding agent or software factory that needs no secret to a workspace, so it can be handed products to build. It never takes a secret field (a key, token or webhook URL): secrets must not pass through this conversation. A provider that needs one is connected by the person themselves, in the web app's Orchestration view or with `attain factories connect` in their own terminal; get_cloud_agent_setup_prompt gives both. Ask for every value that isn't secret; don't guess.","input_schema":{"additionalProperties":false,"properties":{"fields":{"additionalProperties":{"type":"string"},"description":"A value for each of the provider's fields, by key, as list_cloud_agent_providers lists them. Lists (labels, assignees) are separated by commas","type":"object"},"name":{"description":"What to call it; defaults to the provider's name","type":["null","string"]},"provider":{"description":"A provider's id, from list_cloud_agent_providers","type":"string"},"workspace_id":{"description":"Workspace id, from list_workspaces","type":"integer"}},"required":["workspace_id","provider","fields"],"type":"object"},"name":"connect_cloud_agent","params":[{"description":"Workspace id, from list_workspaces","name":"workspace_id","required":true,"type":"integer"},{"description":"A provider's id, from list_cloud_agent_providers","name":"provider","required":true,"type":"string"},{"description":"A value for each of the provider's fields, by key, as list_cloud_agent_providers lists them. Lists (labels, assignees) are separated by commas","name":"fields","required":true,"type":"object"},{"description":"What to call it; defaults to the provider's name","name":"name","required":false,"type":"string"}],"title":"Connect a cloud agent","writes":true},{"description":"Makes a metric key for a product: the secret (attainm_…) a built product sends as Authorization: Bearer \u003ckey\u003e to report its metrics' readings to report_url. The key is returned once, here: store it with the product's other secrets (e.g. ATTAINABLE_METRICS_KEY), never in code, logs or a browser. It can report that product's metrics and its sub-products', and nothing else. Make one per environment that reports.","input_schema":{"additionalProperties":false,"properties":{"name":{"description":"What the key is for, e.g. 'production' or 'staging'","type":"string"},"product_id":{"description":"Product id, from list_workspace_products or list_product_sub_products","type":"integer"}},"required":["product_id","name"],"type":"object"},"name":"create_metric_key","params":[{"description":"Product id, from list_workspace_products or list_product_sub_products","name":"product_id","required":true,"type":"integer"},{"description":"What the key is for, e.g. 'production' or 'staging'","name":"name","required":true,"type":"string"}],"title":"Create a metric key","writes":true},{"description":"Creates a product: the lasting thing a team builds, owns and learns about. At the top level of a workspace, or inside another product as a sub-product (parent_id) when part of it needs its own stream of judgment. Ask the person for its name and what it is and who it is for, then add its first scoping doc with create_scoping_doc. Returns the product with what it still needs, and a link to open it in ://attainable.","input_schema":{"additionalProperties":false,"properties":{"agent":{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","type":["null","string"]},"description":{"description":"What the product is and who it is for, in a sentence or two","type":["null","string"]},"level":{"description":"The model's configured reasoning or effort level, e.g. 'high'","type":["null","string"]},"model":{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","type":["null","string"]},"name":{"description":"The product's name","type":"string"},"parent_id":{"description":"To create a sub-product: the product to put it inside","type":["null","integer"]},"repository":{"description":"The GitHub repository it is built in, as owner/name: one from list_repositories. A sub-product inherits its parent's without it","type":["null","string"]},"source":{"description":"For an import (get_repo_import_prompt): where in the repository it was found, e.g. 'Acme/Storefront:apps/web'. No other product in the workspace may have it","type":["null","string"]},"workspace_id":{"description":"The workspace to create it in (from list_workspaces). Not needed for a sub-product, or if you are on just one workspace.","type":["null","integer"]}},"required":["name"],"type":"object"},"name":"create_product","params":[{"description":"The product's name","name":"name","required":true,"type":"string"},{"description":"What the product is and who it is for, in a sentence or two","name":"description","required":false,"type":"string"},{"description":"The workspace to create it in (from list_workspaces). Not needed for a sub-product, or if you are on just one workspace.","name":"workspace_id","required":false,"type":"integer"},{"description":"To create a sub-product: the product to put it inside","name":"parent_id","required":false,"type":"integer"},{"description":"The GitHub repository it is built in, as owner/name: one from list_repositories. A sub-product inherits its parent's without it","name":"repository","required":false,"type":"string"},{"description":"For an import (get_repo_import_prompt): where in the repository it was found, e.g. 'Acme/Storefront:apps/web'. No other product in the workspace may have it","name":"source","required":false,"type":"string"},{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","name":"agent","required":false,"type":"string"},{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","name":"model","required":false,"type":"string"},{"description":"The model's configured reasoning or effort level, e.g. 'high'","name":"level","required":false,"type":"string"}],"title":"Create a product","writes":true},{"description":"Adds a scoping doc to a product (a product needs at least one somewhere inside it to be ready), with whatever parts of the scope are known so far. It is dated today unless scoped_on is given. Returns the doc with what it still needs.","input_schema":{"additionalProperties":false,"properties":{"agent":{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","type":["null","string"]},"draft":{"description":"For an import (get_repo_import_prompt): true saves it as a draft, which doesn't count toward readiness until a person accepts it","type":["null","boolean"]},"how_we_will_know":{"description":"One or two metrics, each with a threshold, e.g. \"Activation within 7 days above 40%\". Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","items":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"properties":{"id":{"minimum":1,"type":"integer"},"text":{"maxLength":2000,"minLength":1,"type":"string"}},"required":["id","text"],"type":"object"}]},"type":"array"},"hypothesis":{"description":"What you believe will happen, and why. A full sentence or two.","type":["null","string"]},"level":{"description":"The model's configured reasoning or effort level, e.g. 'high'","type":["null","string"]},"model":{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","type":["null","string"]},"product_id":{"description":"Product id, from list_workspace_products or list_product_sub_products","type":"integer"},"scoped_on":{"description":"The date the scope was agreed, YYYY-MM-DD","type":["null","string"]},"source":{"description":"For an import: where in the repository it was drawn from, e.g. 'Acme/Storefront:apps/web#scope'. No other scoping doc in the workspace may have it","type":["null","string"]},"title":{"description":"The scoping doc's title","type":"string"},"what_done_looks_like":{"description":"How you will know it is finished. A full sentence or two.","type":["null","string"]},"what_it_must_do":{"description":"The must-dos: one to five, a few musts rather than a backlog. Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","items":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"properties":{"id":{"minimum":1,"type":"integer"},"text":{"maxLength":2000,"minLength":1,"type":"string"}},"required":["id","text"],"type":"object"}]},"type":"array"},"what_it_will_not_do":{"description":"What it will not do: what might someone assume this also solves? Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","items":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"properties":{"id":{"minimum":1,"type":"integer"},"text":{"maxLength":2000,"minLength":1,"type":"string"}},"required":["id","text"],"type":"object"}]},"type":"array"},"what_you_are_building":{"description":"What is being built. A full sentence or two.","type":["null","string"]},"who_it_is_for":{"description":"Which users, in what situation, trying to do what. A full sentence or two.","type":["null","string"]}},"required":["product_id","title"],"type":"object"},"name":"create_scoping_doc","params":[{"description":"Product id, from list_workspace_products or list_product_sub_products","name":"product_id","required":true,"type":"integer"},{"description":"The scoping doc's title","name":"title","required":true,"type":"string"},{"description":"For an import (get_repo_import_prompt): true saves it as a draft, which doesn't count toward readiness until a person accepts it","name":"draft","required":false,"type":"boolean"},{"description":"For an import: where in the repository it was drawn from, e.g. 'Acme/Storefront:apps/web#scope'. No other scoping doc in the workspace may have it","name":"source","required":false,"type":"string"},{"description":"The date the scope was agreed, YYYY-MM-DD","name":"scoped_on","required":false,"type":"string"},{"description":"What you believe will happen, and why. A full sentence or two.","name":"hypothesis","required":false,"type":"string"},{"description":"One or two metrics, each with a threshold, e.g. \"Activation within 7 days above 40%\". Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","name":"how_we_will_know","required":false,"type":"array of objects"},{"description":"What is being built. A full sentence or two.","name":"what_you_are_building","required":false,"type":"string"},{"description":"Which users, in what situation, trying to do what. A full sentence or two.","name":"who_it_is_for","required":false,"type":"string"},{"description":"The must-dos: one to five, a few musts rather than a backlog. Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","name":"what_it_must_do","required":false,"type":"array of objects"},{"description":"How you will know it is finished. A full sentence or two.","name":"what_done_looks_like","required":false,"type":"string"},{"description":"What it will not do: what might someone assume this also solves? Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","name":"what_it_will_not_do","required":false,"type":"array of objects"},{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","name":"agent","required":false,"type":"string"},{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","name":"model","required":false,"type":"string"},{"description":"The model's configured reasoning or effort level, e.g. 'high'","name":"level","required":false,"type":"string"}],"title":"Create a scoping doc","writes":true},{"description":"Disconnects a cloud agent from its workspace, forgetting its credentials; its runs stay in the history. The workspace's owner or whoever connected it can. Confirm with the person first.","input_schema":{"additionalProperties":false,"properties":{"cloud_agent_id":{"description":"Cloud agent id, from list_cloud_agents","type":"integer"}},"required":["cloud_agent_id"],"type":"object"},"name":"disconnect_cloud_agent","params":[{"description":"Cloud agent id, from list_cloud_agents","name":"cloud_agent_id","required":true,"type":"integer"}],"title":"Disconnect a cloud agent","writes":true},{"description":"Returns agent-ready.md, in Markdown: how any collaborator (a chat assistant, a coding agent, a person) connects to ://attainable over MCP, REST or the attain CLI, signs in, and verifies access. Use it to set up another agent, client or teammate, or to install and sign in to the CLI. The same as https://attainable.software/agent-ready.md and the resource attainable://agent-ready.md.","input_schema":{"additionalProperties":false,"type":"object"},"name":"get_agent_ready_guide","params":[],"title":"Get the agent setup guide","writes":false},{"description":"Returns a ready product's build prompt, in Markdown, without claiming it: to review what an agent would be asked to build. To build it, claim it with get_next_build instead.","input_schema":{"additionalProperties":false,"properties":{"product_id":{"description":"A ready product, from list_workspace_products or list_product_sub_products","type":"integer"}},"required":["product_id"],"type":"object"},"name":"get_build_prompt","params":[{"description":"A ready product, from list_workspace_products or list_product_sub_products","name":"product_id","required":true,"type":"integer"}],"title":"Get a build prompt","writes":false},{"description":"Instructions (Markdown) for connecting one provider to a workspace for the person: what they do first, the fields it takes, how to keep its secrets out of the conversation, and how to check it worked. Follow them.","input_schema":{"additionalProperties":false,"properties":{"provider":{"description":"A provider's id, from list_cloud_agent_providers, e.g. \"devin\" or \"claude\"","type":"string"},"workspace_id":{"description":"Workspace id, from list_workspaces","type":"integer"}},"required":["workspace_id","provider"],"type":"object"},"name":"get_cloud_agent_setup_prompt","params":[{"description":"Workspace id, from list_workspaces","name":"workspace_id","required":true,"type":"integer"},{"description":"A provider's id, from list_cloud_agent_providers, e.g. \"devin\" or \"claude\"","name":"provider","required":true,"type":"string"}],"title":"Get a cloud agent's setup prompt","writes":false},{"description":"A link for the person to install the ://attainable GitHub App on the GitHub organization or account that has their repositories, or to change which repositories it can see. It is the only way to connect repositories. Give the person the link to open in their browser: it works for an hour, for them only, and GitHub sends them back to ://attainable with the repositories connected. Then call list_repositories and link products with update_product (repository).","input_schema":{"additionalProperties":false,"properties":{"workspace_id":{"description":"Workspace id, from list_workspaces","type":"integer"}},"required":["workspace_id"],"type":"object"},"name":"get_github_install_link","params":[{"description":"Workspace id, from list_workspaces","name":"workspace_id","required":true,"type":"integer"}],"title":"Get the GitHub App install link","writes":false},{"description":"Claims a product to build and returns its full build prompt, which lists the workspace_id and product_id (and the ids of everything inside) to use with the other tools. With product_id, claims that product: it must be ready, and not built or being built by someone else; claiming one you already hold renews the claim and returns its prompt again. Without it, claims the next ready, unbuilt product in workspace_id (or in your first workspace with one waiting): products whose dependencies are already built come first. The product is marked as being built, so other agents get a different one; a claim not reported within a day is offered again. If earlier builders released it or its build was marked as not built, the prompt includes their reports under Earlier attempts: continue from them, or release it again if it is still blocked. Follow the prompt, then call report_product_built, or release_build with a release report if you won't finish it.","input_schema":{"additionalProperties":false,"properties":{"agent":{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","type":["null","string"]},"level":{"description":"The model's configured reasoning or effort level, e.g. 'high'","type":["null","string"]},"model":{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","type":["null","string"]},"product_id":{"description":"Claim this product (from list_workspace_products or a build prompt) instead of the next in line","type":["null","integer"]},"workspace_id":{"description":"Only look in this workspace (from list_workspaces). Defaults to the first of your workspaces with something waiting. With product_id, checked to be that product's workspace.","type":["null","integer"]}},"type":"object"},"name":"get_next_build","params":[{"description":"Only look in this workspace (from list_workspaces). Defaults to the first of your workspaces with something waiting. With product_id, checked to be that product's workspace.","name":"workspace_id","required":false,"type":"integer"},{"description":"Claim this product (from list_workspace_products or a build prompt) instead of the next in line","name":"product_id","required":false,"type":"integer"},{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","name":"agent","required":false,"type":"string"},{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","name":"model","required":false,"type":"string"},{"description":"The model's configured reasoning or effort level, e.g. 'high'","name":"level","required":false,"type":"string"}],"title":"Get the next thing to build","writes":true},{"description":"Returns the orchestration prompt for a workspace, in Markdown: every product and sub-product with its id, what it is for, its status (built, being built, ready or not), its scoping docs and must-dos, what depends on what, and the order to dispatch ready products in. Without product_id, it instructs you as the orchestrator: hand each ready product to its own builder agent (get_next_build with its ids), in dependency order, keep them aligned, and track their reports. With the product_id you are building, it instructs you as one builder in that orchestration and starts with where your product fits. Call it again for the latest status.","input_schema":{"additionalProperties":false,"properties":{"product_id":{"description":"The product you are building, if you are a builder rather than the orchestrator","type":["null","integer"]},"workspace_id":{"description":"The workspace (from list_workspaces, or the build prompt's Identifiers)","type":"integer"}},"required":["workspace_id"],"type":"object"},"name":"get_orchestration_prompt","params":[{"description":"The workspace (from list_workspaces, or the build prompt's Identifiers)","name":"workspace_id","required":true,"type":"integer"},{"description":"The product you are building, if you are a builder rather than the orchestrator","name":"product_id","required":false,"type":"integer"}],"title":"Get the orchestration prompt","writes":false},{"description":"Returns one product in full: its name, description, workspace and parent ids, counts of its contents, every readiness check and remaining work, and its current build status. Read it before updating a product or helping someone finish its scope. Use list_product_scoping_docs and list_product_sub_products to read the items inside it.","input_schema":{"additionalProperties":false,"properties":{"product_id":{"description":"Product id, from list_workspace_products or list_product_sub_products","type":"integer"}},"required":["product_id"],"type":"object"},"name":"get_product","params":[{"description":"Product id, from list_workspace_products or list_product_sub_products","name":"product_id","required":true,"type":"integer"}],"title":"Get a product","writes":false},{"description":"Returns a product's metrics, from its scoping docs and its sub-products', each with its id, threshold, how many readings have been reported and the latest ones, and the report_url the product reports to. Use it to check a built product's reports arrive, or to read how each hypothesis is doing against its threshold.","input_schema":{"additionalProperties":false,"properties":{"limit":{"description":"How many of each metric's latest readings to return, 1 to 100 (default 20)","maximum":2147483647,"minimum":-2147483648,"type":["null","integer"]},"product_id":{"description":"Product id, from list_workspace_products or list_product_sub_products","type":"integer"}},"required":["product_id"],"type":"object"},"name":"get_product_metrics","params":[{"description":"Product id, from list_workspace_products or list_product_sub_products","name":"product_id","required":true,"type":"integer"},{"description":"How many of each metric's latest readings to return, 1 to 100 (default 20)","name":"limit","required":false,"type":"integer"}],"title":"Get a product's metrics","writes":false},{"description":"The prompt for importing an existing product from one of the workspace's repositories, for a team whose product is already built: read the repository (have it checked out), create products from its structure, write draft scoping docs citing the files they came from, and report what already exists as built. Drafts don't count toward readiness until a person accepts them, so nothing inferred starts a build. Importing again updates what the last import made: the prompt lists it. Follow the prompt.","input_schema":{"additionalProperties":false,"properties":{"repository":{"description":"The repository to import, as owner/name: one from list_repositories","type":"string"},"workspace_id":{"description":"The workspace to import into, from list_workspaces","type":"integer"}},"required":["workspace_id","repository"],"type":"object"},"name":"get_repo_import_prompt","params":[{"description":"The workspace to import into, from list_workspaces","name":"workspace_id","required":true,"type":"integer"},{"description":"The repository to import, as owner/name: one from list_repositories","name":"repository","required":true,"type":"string"}],"title":"Get a repository's import prompt","writes":false},{"description":"Returns one scoping doc in full: each part of its Builder's Scope with item ids, every readiness check (done or not, and what to do), and the rules for each part. Read it before asking someone about the missing parts, so you can ask about exactly what is missing and build on what is already there.","input_schema":{"additionalProperties":false,"properties":{"document_id":{"description":"Scoping doc id, from list_not_ready_products or list_product_scoping_docs","type":"integer"}},"required":["document_id"],"type":"object"},"name":"get_scoping_doc","params":[{"description":"Scoping doc id, from list_not_ready_products or list_product_scoping_docs","name":"document_id","required":true,"type":"integer"}],"title":"Get a scoping doc","writes":false},{"description":"Invites someone to a workspace's team by email. ://attainable doesn't send email: it returns an invite link, which only that email's account can accept. Give the link to the person who asked, to send on. Inviting the same email again returns the pending invitation (resent).","input_schema":{"additionalProperties":false,"properties":{"email":{"description":"The email address of the person to invite","type":"string"},"workspace_id":{"description":"The workspace whose team to invite them to, from list_workspaces","type":"integer"}},"required":["workspace_id","email"],"type":"object"},"name":"invite_team_member","params":[{"description":"The workspace whose team to invite them to, from list_workspaces","name":"workspace_id","required":true,"type":"integer"},{"description":"The email address of the person to invite","name":"email","required":true,"type":"string"}],"title":"Invite a team member","writes":true},{"description":"The products on hold in a workspace: their builders stopped because they can't go on without a person, needing input (a question or decision) or blocked (by something an agent can't resolve). Each is out of the build queue until someone responds with respond_to_build_hold.","input_schema":{"additionalProperties":false,"properties":{"include_resolved":{"description":"Also list the latest resolved holds, with their responses","type":"boolean"},"workspace_id":{"description":"The workspace (from list_workspaces)","type":"integer"}},"required":["workspace_id"],"type":"object"},"name":"list_build_holds","params":[{"description":"The workspace (from list_workspaces)","name":"workspace_id","required":true,"type":"integer"},{"description":"Also list the latest resolved holds, with their responses","name":"include_resolved","required":false,"type":"boolean"}],"title":"List builders waiting for a person","writes":false},{"description":"Every kind of cloud agent a workspace can connect to build its products: coding agents (a Claude Code routine, an OpenAI agent), software factories (Devin, Warp, Factory, Codegen, Cursor, OpenHands, GitLab Duo, Port, Microsoft Foundry) and other ways in (a webhook, a GitHub issue, an A2A agent, a custom factory). Each has the steps the person takes first and the fields it takes, with which are secrets: connect_cloud_agent connects only a provider that needs no secret. Use it before connecting one.","input_schema":{"additionalProperties":false,"type":"object"},"name":"list_cloud_agent_providers","params":[],"title":"List cloud agent providers","writes":false},{"description":"The cloud agents connected to a workspace (never their secrets), how each is run, their latest runs, and the products ready to hand them.","input_schema":{"additionalProperties":false,"properties":{"workspace_id":{"description":"Workspace id, from list_workspaces","type":"integer"}},"required":["workspace_id"],"type":"object"},"name":"list_cloud_agents","params":[{"description":"Workspace id, from list_workspaces","name":"workspace_id","required":true,"type":"integer"}],"title":"List cloud agents","writes":false},{"description":"Lists every product that is not ready to build yet, at any depth, with what it needs itself and which scoping docs inside it are unfinished, and what each is missing. Use it to help someone finish their scopes: offer them the list, let them pick, then ask for the missing parts one at a time and save each answer (update_product, update_scoping_doc or create_scoping_doc). Don't invent answers: the scope is their decision.","input_schema":{"additionalProperties":false,"properties":{"workspace_id":{"description":"Only this workspace (from list_workspaces). Defaults to all of your workspaces.","type":["null","integer"]}},"type":"object"},"name":"list_not_ready_products","params":[{"description":"Only this workspace (from list_workspaces). Defaults to all of your workspaces.","name":"workspace_id","required":false,"type":"integer"}],"title":"List products that are not ready","writes":false},{"description":"Lists the scoping docs directly inside a product, each with its full Builder's Scope (hypothesis, how we will know, what is being built, who it is for, what it must do, what done looks like, what it will not do) and whether it is ready.","input_schema":{"additionalProperties":false,"properties":{"product_id":{"description":"Product id, from list_workspace_products or list_product_sub_products","type":"integer"}},"required":["product_id"],"type":"object"},"name":"list_product_scoping_docs","params":[{"description":"Product id, from list_workspace_products or list_product_sub_products","name":"product_id","required":true,"type":"integer"}],"title":"List product scoping docs","writes":false},{"description":"Lists the sub-products directly inside a product, with whether each is ready to build and what is left to do if not.","input_schema":{"additionalProperties":false,"properties":{"product_id":{"description":"Product id, from list_workspace_products or list_product_sub_products","type":"integer"}},"required":["product_id"],"type":"object"},"name":"list_product_sub_products","params":[{"description":"Product id, from list_workspace_products or list_product_sub_products","name":"product_id","required":true,"type":"integer"}],"title":"List product sub-products","writes":false},{"description":"The GitHub App installations linked to a workspace and the repositories they give it: the branch each one's builds start from, how many products link to each, and whether it is still available. github_available is false when the server has no GitHub App.","input_schema":{"additionalProperties":false,"properties":{"workspace_id":{"description":"Workspace id, from list_workspaces","type":"integer"}},"required":["workspace_id"],"type":"object"},"name":"list_repositories","params":[{"description":"Workspace id, from list_workspaces","name":"workspace_id","required":true,"type":"integer"}],"title":"List repositories","writes":false},{"description":"Lists the top-level products in a workspace, with whether each is ready to build (it, everything inside it and everything it depends on is complete) and what is left to do if not.","input_schema":{"additionalProperties":false,"properties":{"workspace_id":{"description":"Workspace id, from list_workspaces","type":"integer"}},"required":["workspace_id"],"type":"object"},"name":"list_workspace_products","params":[{"description":"Workspace id, from list_workspaces","name":"workspace_id","required":true,"type":"integer"}],"title":"List workspace products","writes":false},{"description":"Lists the workspaces you are on. Each keeps a separate set of products and scoping docs, with its own team.","input_schema":{"additionalProperties":false,"type":"object"},"name":"list_workspaces","params":[],"title":"List workspaces","writes":false},{"description":"Gives up your claim on a product you got from get_next_build and have not built, so it is ready again and offered to the next agent. Use it whenever the build will not be finished: an error you can't fix, a build or test that won't pass, a blocker outside your control, the person asked to stop, or the scope needs work first. Include a release report as reason: the next agent to claim the product is given it, to continue your work or to stop if the product is still blocked. Only your own claims can be released; a product being built as part of a product above it is released with that product. Nothing that was built is undone.","input_schema":{"additionalProperties":false,"properties":{"agent":{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","type":["null","string"]},"level":{"description":"The model's configured reasoning or effort level, e.g. 'high'","type":["null","string"]},"model":{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","type":["null","string"]},"outcome":{"description":"released (the default: offered to the next agent), needs_input (a person has to answer a question or make a decision: put the question in reason) or blocked (something an agent can't resolve is in the way: an outside service, missing access or credentials). needs_input and blocked put the product on hold, out of the queue, until someone on the team responds in ://attainable; the build then starts again with the response","type":["null","string"]},"product_id":{"description":"The product to release, from get_next_build or its build prompt","type":"integer"},"reason":{"description":"The release report, in Markdown: what you did, what failed and the errors, what is left, where your work is (branch, pull request or commit), and whether another attempt can succeed or something outside an agent's control has to change first. Shown in ://attainable's agent activity and given to the next agent that claims the product","type":["null","string"]},"workspace_id":{"description":"The product's workspace, from get_next_build or the build prompt: checked, so a release can't land on the wrong product","type":["null","integer"]}},"required":["product_id"],"type":"object"},"name":"release_build","params":[{"description":"The product to release, from get_next_build or its build prompt","name":"product_id","required":true,"type":"integer"},{"description":"The product's workspace, from get_next_build or the build prompt: checked, so a release can't land on the wrong product","name":"workspace_id","required":false,"type":"integer"},{"description":"The release report, in Markdown: what you did, what failed and the errors, what is left, where your work is (branch, pull request or commit), and whether another attempt can succeed or something outside an agent's control has to change first. Shown in ://attainable's agent activity and given to the next agent that claims the product","name":"reason","required":false,"type":"string"},{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","name":"agent","required":false,"type":"string"},{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","name":"model","required":false,"type":"string"},{"description":"The model's configured reasoning or effort level, e.g. 'high'","name":"level","required":false,"type":"string"},{"description":"released (the default: offered to the next agent), needs_input (a person has to answer a question or make a decision: put the question in reason) or blocked (something an agent can't resolve is in the way: an outside service, missing access or credentials). needs_input and blocked put the product on hold, out of the queue, until someone on the team responds in ://attainable; the build then starts again with the response","name":"outcome","required":false,"type":"string"}],"title":"Release a claimed product","writes":true},{"description":"Records readings of a product's metrics: each metric's value as its build defined it, when it was true, and optionally the period and segment. Built products report on their own with a metric key (see create_metric_key); use this for a baseline taken before a change ships, or a metric whose data comes from outside the product.","input_schema":{"additionalProperties":false,"properties":{"product_id":{"description":"Product id, from list_workspace_products or list_product_sub_products","type":"integer"},"readings":{"description":"Up to 500 readings of the product's metrics or its sub-products'","items":{"additionalProperties":false,"properties":{"dimensions":{"additionalProperties":{"type":"string"},"description":"The segment the value is for, e.g. {\"segment\": \"new teams\"}. No personal data","type":"object"},"event_id":{"description":"Makes the reading idempotent: one with an event_id already recorded for the metric is skipped","type":["null","string"]},"metric_id":{"description":"The metric, by its id in the build prompt's measurement plan or get_product_metrics","type":"integer"},"note":{"description":"Anything a reader should know, e.g. 'baseline, before the change shipped'","type":["null","string"]},"observed_at":{"description":"When the value was true, RFC 3339 (e.g. 2026-11-16T09:00:00Z). Defaults to now","type":["null","string"]},"value":{"description":"The metric's value, in the units its threshold uses","type":"number"},"window":{"description":"The period the value covers, e.g. 'P7D' or '2026-11'","type":["null","string"]}},"required":["metric_id","value"],"type":"object"},"type":["null","array"]},"validate_only":{"description":"Check the readings without recording them","type":"boolean"}},"required":["product_id","readings"],"type":"object"},"name":"report_metrics","params":[{"description":"Product id, from list_workspace_products or list_product_sub_products","name":"product_id","required":true,"type":"integer"},{"description":"Up to 500 readings of the product's metrics or its sub-products'","name":"readings","required":true,"type":"array of object"},{"description":"Check the readings without recording them","name":"validate_only","required":false,"type":"boolean"}],"title":"Report metric readings","writes":true},{"description":"Records that a product has been built, once its build is finished and verified against its build prompt. It then shows as built in ://attainable, and get_next_build moves on. Include what was built, what was stubbed and anything flagged.","input_schema":{"additionalProperties":false,"properties":{"agent":{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","type":["null","string"]},"level":{"description":"The model's configured reasoning or effort level, e.g. 'high'","type":["null","string"]},"model":{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","type":["null","string"]},"product_id":{"description":"The product that was built, from get_next_build or its build prompt","type":"integer"},"summary":{"description":"What was built, what was stubbed or flagged, and where the metrics can be read","type":"string"},"workspace_id":{"description":"The product's workspace, from get_next_build or the build prompt: checked, so a report can't land on the wrong product","type":["null","integer"]}},"required":["product_id","summary"],"type":"object"},"name":"report_product_built","params":[{"description":"The product that was built, from get_next_build or its build prompt","name":"product_id","required":true,"type":"integer"},{"description":"The product's workspace, from get_next_build or the build prompt: checked, so a report can't land on the wrong product","name":"workspace_id","required":false,"type":"integer"},{"description":"What was built, what was stubbed or flagged, and where the metrics can be read","name":"summary","required":true,"type":"string"},{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","name":"agent","required":false,"type":"string"},{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","name":"model","required":false,"type":"string"},{"description":"The model's configured reasoning or effort level, e.g. 'high'","name":"level","required":false,"type":"string"}],"title":"Report a product as built","writes":true},{"description":"Answers a hold with a person's response: the product goes back in the build queue, and the next builder is given the response in its build prompt. When a cloud agent raised the hold, its run is stopped and the cloud agent runs again with the response.","input_schema":{"additionalProperties":false,"properties":{"hold_id":{"description":"The hold, from list_build_holds","type":"integer"},"response":{"description":"The person's answer, decision or what changed, in Markdown: given to the next builder in its build prompt. Theirs to give: ask them, don't invent it","type":"string"}},"required":["hold_id","response"],"type":"object"},"name":"respond_to_build_hold","params":[{"description":"The hold, from list_build_holds","name":"hold_id","required":true,"type":"integer"},{"description":"The person's answer, decision or what changed, in Markdown: given to the next builder in its build prompt. Theirs to give: ask them, don't invent it","name":"response","required":true,"type":"string"}],"title":"Respond to a builder waiting for a person","writes":true},{"description":"Hands a cloud agent one ready product to build (product_id), or the whole workspace to orchestrate (orchestrate: true). It is sent the build or orchestration prompt with a token for the run, and the run shows in list_cloud_agents.","input_schema":{"additionalProperties":false,"properties":{"cloud_agent_id":{"description":"Cloud agent id, from list_cloud_agents","type":"integer"},"orchestrate":{"description":"Hand it the whole workspace to orchestrate instead of one product","type":"boolean"},"product_id":{"description":"A ready product to hand it, from list_cloud_agents' ready list. Leave out to orchestrate","type":["null","integer"]}},"required":["cloud_agent_id"],"type":"object"},"name":"run_cloud_agent","params":[{"description":"Cloud agent id, from list_cloud_agents","name":"cloud_agent_id","required":true,"type":"integer"},{"description":"A ready product to hand it, from list_cloud_agents' ready list. Leave out to orchestrate","name":"product_id","required":false,"type":"integer"},{"description":"Hand it the whole workspace to orchestrate instead of one product","name":"orchestrate","required":false,"type":"boolean"}],"title":"Run a cloud agent","writes":true},{"description":"Reads each GitHub App installation's repositories from GitHub again, for when a repository added or removed on GitHub hasn't shown up in list_repositories.","input_schema":{"additionalProperties":false,"properties":{"workspace_id":{"description":"Workspace id, from list_workspaces","type":"integer"}},"required":["workspace_id"],"type":"object"},"name":"sync_repositories","params":[{"description":"Workspace id, from list_workspaces","name":"workspace_id","required":true,"type":"integer"}],"title":"Refresh repositories from GitHub","writes":true},{"description":"Sets a connected cloud agent's dispatch policy and limits. Automatic runs (on_ready, orchestrate) start as you. Saving it lifts a pause. Ask the person which they want.","input_schema":{"additionalProperties":false,"properties":{"cloud_agent_id":{"description":"Cloud agent id, from list_cloud_agents","type":"integer"},"dispatch":{"description":"How it is run: \"manual\" (someone runs it), \"on_ready\" (each product as it becomes ready) or \"orchestrate\" (the whole workspace, whenever something is ready)","type":["null","string"]},"max_per_day":{"description":"How many runs may start in any 24 hours, 1 to 100","maximum":2147483647,"minimum":-2147483648,"type":["null","integer"]},"max_running":{"description":"How many of its runs may go at once, 1 to 20","maximum":2147483647,"minimum":-2147483648,"type":["null","integer"]}},"required":["cloud_agent_id"],"type":"object"},"name":"update_cloud_agent","params":[{"description":"Cloud agent id, from list_cloud_agents","name":"cloud_agent_id","required":true,"type":"integer"},{"description":"How it is run: \"manual\" (someone runs it), \"on_ready\" (each product as it becomes ready) or \"orchestrate\" (the whole workspace, whenever something is ready)","name":"dispatch","required":false,"type":"string"},{"description":"How many of its runs may go at once, 1 to 20","name":"max_running","required":false,"type":"integer"},{"description":"How many runs may start in any 24 hours, 1 to 100","name":"max_per_day","required":false,"type":"integer"}],"title":"Set how a cloud agent is run","writes":true},{"description":"Changes a product's name or description (what it is and who it is for), or the GitHub repository it is built in. Returns its readiness afterwards: what it still needs, and its scoping docs.","input_schema":{"additionalProperties":false,"properties":{"agent":{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","type":["null","string"]},"description":{"description":"What the product is and who it is for","type":["null","string"]},"level":{"description":"The model's configured reasoning or effort level, e.g. 'high'","type":["null","string"]},"model":{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","type":["null","string"]},"name":{"description":"The product's new name","type":["null","string"]},"product_id":{"description":"Product id, from list_workspace_products or list_product_sub_products","type":"integer"},"repository":{"description":"The GitHub repository it is built in, as owner/name: one from list_repositories. \"\" unlinks it, so it inherits its parent's","type":["null","string"]},"source":{"description":"For an import: where in the repository it was found (from get_repo_import_prompt). \"\" clears it","type":["null","string"]}},"required":["product_id"],"type":"object"},"name":"update_product","params":[{"description":"Product id, from list_workspace_products or list_product_sub_products","name":"product_id","required":true,"type":"integer"},{"description":"The product's new name","name":"name","required":false,"type":"string"},{"description":"What the product is and who it is for","name":"description","required":false,"type":"string"},{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","name":"agent","required":false,"type":"string"},{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","name":"model","required":false,"type":"string"},{"description":"The model's configured reasoning or effort level, e.g. 'high'","name":"level","required":false,"type":"string"},{"description":"The GitHub repository it is built in, as owner/name: one from list_repositories. \"\" unlinks it, so it inherits its parent's","name":"repository","required":false,"type":"string"},{"description":"For an import: where in the repository it was found (from get_repo_import_prompt). \"\" clears it","name":"source","required":false,"type":"string"}],"title":"Update a product","writes":true},{"description":"Saves parts of a scoping doc's Builder's Scope, as the person gives them; send only the parts that change. Returns the doc with what it still needs, and its product's readiness, so you know what to ask next.","input_schema":{"additionalProperties":false,"properties":{"agent":{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","type":["null","string"]},"document_id":{"description":"Scoping doc id, from list_not_ready_products or list_product_scoping_docs","type":"integer"},"draft":{"description":"false accepts an imported draft, once the person has reviewed it and told you so: from then on it counts toward readiness","type":["null","boolean"]},"how_we_will_know":{"description":"One or two metrics, each with a threshold, e.g. \"Activation within 7 days above 40%\". Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","items":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"properties":{"id":{"minimum":1,"type":"integer"},"text":{"maxLength":2000,"minLength":1,"type":"string"}},"required":["id","text"],"type":"object"}]},"type":"array"},"hypothesis":{"description":"What you believe will happen, and why. A full sentence or two.","type":["null","string"]},"level":{"description":"The model's configured reasoning or effort level, e.g. 'high'","type":["null","string"]},"model":{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","type":["null","string"]},"scoped_on":{"description":"The date the scope was agreed, YYYY-MM-DD","type":["null","string"]},"source":{"description":"For an import: where in the repository it was drawn from (from get_repo_import_prompt). \"\" clears it","type":["null","string"]},"title":{"description":"The scoping doc's title","type":["null","string"]},"what_done_looks_like":{"description":"How you will know it is finished. A full sentence or two.","type":["null","string"]},"what_it_must_do":{"description":"The must-dos: one to five, a few musts rather than a backlog. Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","items":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"properties":{"id":{"minimum":1,"type":"integer"},"text":{"maxLength":2000,"minLength":1,"type":"string"}},"required":["id","text"],"type":"object"}]},"type":"array"},"what_it_will_not_do":{"description":"What it will not do: what might someone assume this also solves? Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","items":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"properties":{"id":{"minimum":1,"type":"integer"},"text":{"maxLength":2000,"minLength":1,"type":"string"}},"required":["id","text"],"type":"object"}]},"type":"array"},"what_you_are_building":{"description":"What is being built. A full sentence or two.","type":["null","string"]},"who_it_is_for":{"description":"Which users, in what situation, trying to do what. A full sentence or two.","type":["null","string"]}},"required":["document_id"],"type":"object"},"name":"update_scoping_doc","params":[{"description":"Scoping doc id, from list_not_ready_products or list_product_scoping_docs","name":"document_id","required":true,"type":"integer"},{"description":"The scoping doc's title","name":"title","required":false,"type":"string"},{"description":"false accepts an imported draft, once the person has reviewed it and told you so: from then on it counts toward readiness","name":"draft","required":false,"type":"boolean"},{"description":"For an import: where in the repository it was drawn from (from get_repo_import_prompt). \"\" clears it","name":"source","required":false,"type":"string"},{"description":"The date the scope was agreed, YYYY-MM-DD","name":"scoped_on","required":false,"type":"string"},{"description":"What you believe will happen, and why. A full sentence or two.","name":"hypothesis","required":false,"type":"string"},{"description":"One or two metrics, each with a threshold, e.g. \"Activation within 7 days above 40%\". Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","name":"how_we_will_know","required":false,"type":"array of objects"},{"description":"What is being built. A full sentence or two.","name":"what_you_are_building","required":false,"type":"string"},{"description":"Which users, in what situation, trying to do what. A full sentence or two.","name":"who_it_is_for","required":false,"type":"string"},{"description":"The must-dos: one to five, a few musts rather than a backlog. Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","name":"what_it_must_do","required":false,"type":"array of objects"},{"description":"How you will know it is finished. A full sentence or two.","name":"what_done_looks_like","required":false,"type":"string"},{"description":"What it will not do: what might someone assume this also solves? Replaces the whole list: send every item to keep. Send an existing item as { id, text } (ids from get_scoping_doc) to keep it, and anything depending on it; a string with an existing item's exact text keeps it too.","name":"what_it_will_not_do","required":false,"type":"array of objects"},{"description":"The agent product making the change, e.g. 'Claude Code' or 'Codex'","name":"agent","required":false,"type":"string"},{"description":"The model used for this activity, e.g. 'claude-opus-5-5' or 'gpt-5.1'","name":"model","required":false,"type":"string"},{"description":"The model's configured reasoning or effort level, e.g. 'high'","name":"level","required":false,"type":"string"}],"title":"Update a scoping doc","writes":true}]}
