import { TRIAL_DAYS } from './billing.js';
export const PRIVACY = `# Privacy policy

*Effective date: 2026-10-16*

The privacy of your data (and it is your data, not ours!) is a big deal to us. In this policy, we lay out: what data we collect and why; how your data is handled; and your rights with respect to your data. We promise we never sell your data: never have, never will.

This policy applies to weave, the hosted workspace and graph datastore at weave.grunion.ai, built and maintained by [Entity name] (together, "weave").

This policy applies to our handling of information about site visitors, prospective customers, and customers and authorized users (in relation to their procurement of the services and management of their relationship with [Entity name]). We refer collectively to these categories of individuals as "you" throughout this policy.

However, this policy does not cover information about a customer's end users that [Entity name] receives from a customer, or otherwise processes on a customer's behalf, in connection with the services provided by [Entity name] to the customer pursuant to an applicable services agreement (including the content of messages of customer end users ("End User Communications")). [Entity name] processes End User Communications as directed by the relevant customer, which is the "data controller" or "business" (or occupies a similar role as defined in applicable privacy laws), as described in the applicable services agreement between such customer and [Entity name]. [Entity name]'s obligations as a "data processor" or "service provider" with respect to such information are defined in such services agreement and applicable data protection addendum and are not made part of this policy.

If you are a customer's end user and you have questions about how your information is collected and processed through the services, please contact the organization who has provided your information to us for more information.

## What we collect and why

Our guiding principle is to collect only what we need. Here's what that means in practice:

### Identity and access

We receive identifying information from the sign-in provider when you sign in to weave: the provider's identifier for your account, the name on your provider profile and, when the provider has verified it, your email address. We keep one verified email address for each sign-in and use the name on your provider profile to name your weave account when you create one. We keep nothing else from your provider profile: no picture or other details. That's so we can match you to your account, show you the workspaces you have been invited to when you sign in, and send you the notifications you ask for. Deleting your account deletes the address.

We'll never sell your personal information to third parties, and we won't use your name or company in marketing statements without your permission either.

### Product interactions

We store on our servers the content that you upload or receive or maintain in your weave workspaces. This is so you can use weave as intended, for example, to create tables, rows and documents. We keep this content as long as your account is active. If you delete your account, we'll delete the content within 60 days.

### Sign-in data

We record the browser description (user agent) and the times of each signed-in session for security and fraud prevention purposes, and we keep this login data for as long as your account is active. We use the IP address of a sign-in request to limit repeated sign-in attempts.

### Display performance

When a weave page jumps or stalls while it draws, your browser sends our server a short report: how far the page moved or how long it stalled, the tag and style class names of the element that moved, the page address with workspace names and record ids removed, the window size, the browser engine and the weave version. The report sets no cookie and carries no account, name, email address or workspace content, and we do not keep the IP address it came from. We write it to the server log so we can find and fix the jump. A self-hosted weave instance writes these reports only to its own server log, and a local install sends none.

### Cookies

We use first-party cookies to keep you signed in and to complete a sign-in with the sign-in provider. Clerk, our sign-in provider, sets its own cookies during sign-in. We also keep your cookie choice in a first-party cookie on the .grunion.ai domain, so one choice covers both weave.grunion.ai and grunion.ai.

We use PostHog Cloud (US region) for product analytics, and we load it only after you click Accept on the cookie banner. PostHog then sets a first-party cookie on .grunion.ai so it can recognize the same browser on grunion.ai and in weave. We record these analytics events: the pages you view, which call to action you click, the referring site, and the campaign tags in the link that brought you to us (utm parameters, plus the gclid and fbclid ad click ids from Google and Meta). In weave we also record which onboarding step you have reached: account, workspace, template or agent connected. Signed-in use of the app also records named actions (creating a workspace, table, row or agent token, using a template, sending or accepting an invite) and daily return visits, never their content. Events from signed-in users carry the Clerk user id. No event carries an email address, workspace content or form input, and session replay is off.

We use this data to count how many visitors move through each onboarding step and which ads and pages brought them.

If you click Decline, we set no analytics cookies and send no analytics events. You can change your choice from the Cookies link in the footer.

A self-hosted weave instance sends nothing to PostHog unless its operator sets their own PostHog key.

A cookie is a piece of text stored by your browser. It may help remember login information and site preferences. You can adjust cookie retention settings and accept or block individual cookies in your browser settings, although weave won't work and other aspects of our service may not function properly if you turn cookies off.

### Voluntary correspondence

We keep the correspondence you send [Entity name] by email with a question or to ask for help, including your email address, so that we have a history of past correspondence to reference if you reach out in the future.

We also store information you may volunteer, for example, written responses to surveys. If you agree to a customer interview, we may ask for your permission to record the conversation for future reference or use, and we will only record it with your express consent.

## When we access or disclose your information

**To provide products or services you've requested.** We use some third-party subprocessors to help run weave and provide the Services to you:

* **Clerk** handles sign-in and account authentication, including Google sign-in through Clerk.
* **Railway** hosts the weave application and stores its data.
* **Cloudflare** provides DNS for weave.grunion.ai.
* **PostHog** (PostHog Inc., US) provides product analytics, only with your consent through the cookie banner.

We may disclose your information at your direction if you integrate a third-party service into your use of weave.

No [Entity name] human looks at your content except for limited purposes with your express permission, for example, if an error occurs that stops an automated process from working and requires manual intervention to fix. These are rare cases, and when they happen, we look for root cause solutions as much as possible to avoid them recurring. We may also access your data if required in order to respond to legal process (see "When required under applicable law" below).

**To help you troubleshoot or squash a software bug, with your permission.** If at any point we need to access your content to help you with a support case, we will ask for your consent before proceeding.

**To investigate, prevent, or take action regarding restricted uses** (see the Use Restrictions section of our Terms of Service). Accessing a customer's account when investigating potential abuse is a measure of last resort. We want to protect the privacy and safety of both our customers and the people reporting issues to us, and we do our best to balance those responsibilities throughout the process. If we discover you are using weave for a restricted purpose, we will take action as necessary, including notifying appropriate authorities where warranted.

**Aggregated and de-identified data.** We may aggregate and/or de-identify information collected through the services. We may use de-identified or aggregated data for any purpose, including marketing or analytics.

**When required under applicable law.** [Entity name] is a U.S. company and all data infrastructure are located in the U.S.

* Requests for user data. Our policy is to not respond to government requests for user data unless we are compelled by legal process or in limited circumstances in the event of an emergency request. However, if U.S. law enforcement authorities have the necessary warrant, criminal subpoena, or court order requiring us to disclose data, we must comply. Likewise, we will only respond to requests from government authorities outside the U.S. if compelled by the U.S. government through procedures outlined in a mutual legal assistance treaty or agreement. It is [Entity name]'s policy to notify affected users before we disclose data unless we are legally prohibited from doing so, and except in some emergency cases.
* Preservation requests. Similarly, [Entity name]'s policy is to comply with requests to preserve data only if compelled by the U.S. Federal Stored Communications Act, 18 U.S.C. Section 2703(f), or by a properly served U.S. subpoena for civil matters. We do not disclose preserved data unless required by law or compelled by a court order that we choose not to appeal. Unless we receive a proper warrant, court order, or subpoena before the required preservation period expires, we will destroy any preserved copies of customer data at the end of the preservation period.

Finally, if [Entity name] is acquired by or merges with another company (we don't plan on that, but if it happens), we'll notify you well before any of your personal information is transferred or becomes subject to a different privacy policy.

## Your rights with respect to your information

At [Entity name], we strive to apply the same data rights to all customers, regardless of their location. Some of these rights include:

* **Right to Know.** You have the right to know what personal information is collected, used, shared or sold. We outline both the categories and specific bits of data we collect, as well as how they are used, in this privacy policy.
* **Right of Access.** This includes your right to access the personal information we gather about you, and your right to obtain information about the sharing, storage, security and processing of that information.
* **Right to Correction.** You have the right to request correction of your personal information.
* **Right to Erasure / "To Be Forgotten".** This is your right to request, subject to certain limitations under applicable law, that your personal information be erased from our possession and, by extension, from all of our service providers. Fulfillment of some data deletion requests may prevent you from using weave because the application may then no longer work. In such cases, a data deletion request may result in closing your account.
* **Right to Complain.** You have the right to make a complaint regarding our handling of your personal information with the appropriate supervisory authority.
* **Right to Restrict Processing.** This is your right to request restriction of how and why your personal information is used or processed, including opting out of sale of your personal information. (Again: we never have and never will sell your personal data.)
* **Right to Object.** You have the right, in certain situations, to object to how or why your personal information is processed.
* **Right to Portability.** You have the right to receive the personal information we have about you and the right to transmit it to another party. If you want to export data from your workspaces, you can do so directly with weave's workspace export.
* **Right to not Be Subject to Automated Decision-Making.** You have the right to object to and prevent any decision that could have a legal or similarly significant effect on you from being made solely based on automated processes. This right is limited if the decision is necessary for performance of any contract between you and us, is allowed by applicable law, or is based on your explicit consent.
* **Right to Non-Discrimination.** We do not and will not charge you a different amount to use weave, offer you different discounts, or give you a lower level of customer service because you have exercised your data privacy rights. However, the exercise of certain rights may, by virtue of your exercising those rights, prevent you from using our Services.

Many of these rights can be exercised by signing in and updating your account information. Please note that certain information may be exempt from such requests under applicable law; for example, we need to retain certain information in order to provide our services to you.

In some cases, we also need to take reasonable steps to verify your identity before responding to a request, which may include, at a minimum, depending on the sensitivity of the information you are requesting and the type of request you are making, verifying your name and email address. If we are unable to verify you, we may be unable to respond to your requests. If you have questions about exercising these rights or need assistance, please contact us at [weave@grunion.ai](mailto:weave@grunion.ai). If an authorized agent is corresponding on your behalf, we will need written consent with a signature from the account holder before proceeding.

Depending on applicable law, you may have the right to appeal our decision to deny your request, if applicable. We will provide information about how to exercise that right in our response denying the request. You also have the right to lodge a complaint with a supervisory authority. If you are in the EU or UK, you can contact your data protection authority to file a complaint or learn more about local privacy laws.

## How we secure your data

All data is encrypted via SSL/TLS when transmitted from our servers to your browser. Most data are not encrypted while they live in our database (since they need to be ready to send to you when you need them).

## What happens when you delete content in your workspaces

Anything you trash in your workspaces while your account is active stays in the trash, where you can restore it, until it is purged.

If you choose to cancel your account, your content will become immediately inaccessible and should be purged from our systems in full within 60 days.

## Data retention

We keep your information for the time necessary for the purposes for which it is processed. The length of time for which we retain information depends on the purposes for which we collected and use it and your choices, after which time we may delete and/or aggregate it. We may also retain and use this information as necessary to comply with our legal obligations, resolve disputes, and enforce our agreements. Through this policy, we have provided specific retention periods for certain types of information.

## Location of site and data

Weave and our other web properties are operated in the United States. If you are located in the European Union, UK, or elsewhere outside of the United States, **please be aware that any information you provide to us will be transferred to and stored in the United States**. By using our websites or Services and/or providing us with your personal information, you consent to this transfer.

## Changes and questions

We may update this policy as needed to comply with relevant regulations and reflect any new practices. You can view a history of the changes to this policy in weave's public repository, [github.com/grunion-ai/weave](https://github.com/grunion-ai/weave). Whenever we make a significant change to our policies, we will refresh the date at the top of this page and take any other appropriate steps to notify users.

Have any questions, comments, or concerns about this privacy policy, your data, or your rights with respect to your information? Please get in touch by emailing us at [weave@grunion.ai](mailto:weave@grunion.ai) and we'll be happy to try to answer them!

---

Adapted from the Basecamp open-source policies ([github.com/basecamp/policies](https://github.com/basecamp/policies)), licensed [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
`;

export const TERMS = `# Terms of Service

*Effective date: 2026-11-10*

From everyone at [Entity name], thank you for using weave! We build it to help you do your best work. Because we don't know every one of our customers personally, we have put in place some Terms of Service.

In this document, "Company", "we", "our", or "us" refers to [Entity name].

"Services" means weave at weave.grunion.ai and any website, application or API that [Entity name] operates for weave, whether delivered within a web browser or another format.

"You" or "your" refers to the people or organizations that own an account with the Services.

We may update these Terms of Service ("Terms") in the future. You can track all changes in weave's public repository, [github.com/grunion-ai/weave](https://github.com/grunion-ai/weave). Whenever we make a significant change to our policies, we will refresh the date at the top of this page and take any other appropriate steps to notify account holders.

By using our Services, now or in the future, you are agreeing to the latest Terms. There may be times where we do not exercise or enforce a right or provision of the Terms; however, that does not mean we are waiving that right or provision. **These Terms do contain a limitation of our liability.**

If you violate any of the Terms, we may terminate your account. That's a broad statement and it means you need to place a lot of trust in us. We keep an open door to your feedback at [weave@grunion.ai](mailto:weave@grunion.ai).

## Account Terms

1. You are responsible for maintaining the security of your account and password and for ensuring that any of your users do the same. The Company cannot and will not be liable for any loss or damage from your failure to comply with this security obligation. We recommend all users turn on two-factor authentication with their sign-in provider for added security. We may require it.
2. You may not use the Services for any purpose outlined in the Use Restrictions section below, and you may not permit any of your users to do so, either.
3. You are responsible for all content posted to and activity that occurs under your account, including content posted by and activity of any users in your account.
4. You must be a human. Accounts registered by "bots" or other automated methods are not permitted. An account holder may issue access tokens to agents and scripts; activity through those tokens is activity under that account.

## Billing and Seats

1. Each workspace pays for weave by the seat. Each Editor and each Architect takes a paid seat. Observers read and comment for free and take no seat.
2. A new workspace starts with a free trial of ${TRIAL_DAYS} days. The trial needs no payment card. During the trial, every Editor and Architect can create and edit.
3. At the end of the trial, weave charges you nothing. Your records stay in the workspace, and everyone can still read and comment. Creating and editing then need a paid seat.
4. An Architect subscribes on the workspace's Billing page. The price of a seat is the price shown on the Billing page and at checkout, before you pay. Clerk Billing runs the checkout and Stripe processes the payment. The subscription renews each month and charges the card on file for every paid seat.
5. Add a seat during a month and you pay only for the part of the month that remains. Removing an Editor or Architect, or making them an Observer, frees their seat, which stays on the subscription until it renews. At renewal, the seat count matches the paid people in the workspace.
6. To cancel, an Architect cancels the subscription on the workspace's Billing page. You can also write to [weave@grunion.ai](mailto:weave@grunion.ai) and we will cancel it for you. Your paid seats keep working until the end of the month you paid for. After that, weave makes no further charge, and Editors and Architects keep reading and commenting until you subscribe again.
7. Clerk Billing does not issue refunds. You get no refund when you cancel, remove a seat or stop using weave partway through a month. Any refund is one we issue by hand through Stripe. To ask about a charge, write to [weave@grunion.ai](mailto:weave@grunion.ai).
8. A workspace made before weave began billing is never charged.
9. Our mailing address for billing questions is 4845 Pearl East Cir STE 118 PMB 720820, Boulder, CO 80301.

## Cancellation and Termination

1. You are solely responsible for properly canceling your account. To cancel your account, or if you need help canceling it, contact us at [weave@grunion.ai](mailto:weave@grunion.ai).
2. All of your content will be inaccessible from the Services immediately upon account cancellation. Within 30 days, all content will be permanently deleted from active systems and logs. Within 60 days, all content will be permanently deleted from our backups. We cannot recover this information once it has been permanently deleted. If you want to export any data before your account is canceled, use weave's workspace export.
3. We have the right to suspend or terminate your account and refuse any and all current or future use of our Services for any reason at any time. Suspension means you and any other users on your account will not be able to access the account or any content in the account; termination will furthermore delete your account or your access to your account, and you forfeit and relinquish all content in your account. We also reserve the right to refuse the use of the Services to anyone for any reason at any time (for more details, see the Use Restrictions section below).
4. Verbal, physical, written or other abuse (including threats of abuse or retribution) of a Company employee or officer will result in immediate account termination.

## Modifications to the Service

Sometimes it becomes technically impossible to continue a feature or we redesign a part of our Services because we think it could be better or we decide to close new signups. We reserve the right at any time to modify or discontinue, temporarily or permanently, any part of our Services with or without notice.

## Uptime, Security, and Privacy

1. Your use of the Services is at your sole risk. We provide these Services on an "as is" and "as available" basis. We do not offer service-level agreements for our Services, but do take uptime of our applications seriously.
2. We reserve the right to temporarily disable your account if your usage significantly exceeds the average usage of other customers of the Services. Of course, we'll reach out to the account owner before taking any action except in rare cases where the level of use may negatively impact how the Service performs for other customers.
3. We take measures to protect and secure your data, including encryption, and we enforce encryption for data transmission from the public Internet. To report a security incident or threat, email [weave@grunion.ai](mailto:weave@grunion.ai).
4. By using our Services, you entrust us with your data. We take that trust to heart. You agree that [Entity name] may process your data as described in our [Privacy policy](/privacy) and for no other purpose. We as humans can access your data for the following reasons:
  * **To help you with support requests you make.** We'll ask for express consent before accessing your account.
  * **On the rare occasions when an error occurs that stops an automated process partway through.** We get automated alerts when such errors occur. If we can fix the issue and restart automated processing without looking at any personal data, we do. In rare cases, we have to look at a minimum amount of personal data to fix the issue. In these rare cases, we aim to fix the root cause to prevent the errors from recurring.
  * **To safeguard [Entity name].** We'll look at logs and metadata as part of our work to ensure the security of your data and the Services as a whole. If necessary, we may also access accounts as part of an abuse report investigation.
  * **To the extent required by applicable law.** As a US company with all data infrastructure located in the US, we only preserve or share customer data if compelled by a US government authority with a legally binding order or proper request under the Stored Communications Act, or in limited circumstances in the event of an emergency request. If a non-US authority approaches [Entity name] for assistance, our default stance is to refuse unless the order has been approved by the US government, which compels us to comply through procedures outlined in an established mutual legal assistance treaty or agreement mechanism.
5. We use third party vendors and hosting partners to provide the necessary hardware, software, networking, storage, and related technology required to run the Services. Our [Privacy policy](/privacy) lists the subprocessors who handle personal data.
6. Under the California Consumer Privacy Act ("CCPA"), [Entity name] is a "service provider", not a "business" or "third party", with respect to your use of the Services. That means we process any data you share with us only for the purpose you signed up for and as described in these Terms and the [Privacy policy](/privacy), and we do not retain, use, disclose, or sell any of that information for any other commercial purposes unless we have your explicit permission. And on the flip-side, you agree to comply with your requirements under the CCPA and not use the Services in a way that violates the regulations.

## Copyright and Content Ownership

1. All content posted on the Services must comply with U.S. copyright law. To file a copyright infringement claim, email [weave@grunion.ai](mailto:weave@grunion.ai).
2. You give us a limited license to use the content posted by you and your users in order to provide the Services to you, but we claim no ownership rights over those materials. All materials you submit to the Services remain yours.
3. We do not pre-screen content, but we reserve the right (but not the obligation) in our sole discretion to refuse or remove any content that is available via the Service.
4. The Company or its licensors own all right, title, and interest in and to the Services, including all intellectual property rights therein, and you obtain no ownership rights in the Services as a result of your use. Except as the license of weave's public source code allows, you may not duplicate, copy, or reuse any portion of the HTML, CSS, JavaScript, or visual design elements without express written permission from the Company. You must request permission to use the Company's logos or any Service logos for promotional purposes. Please email requests to use logos to [weave@grunion.ai](mailto:weave@grunion.ai). We reserve the right to rescind any permissions if you violate these Terms.
5. Except as the license of weave's public source code allows, you agree not to reproduce, duplicate, copy, sell, resell or exploit any portion of the Services, use of the Services, or access to the Services without the express written permission of the Company.

## Features and Bugs

We design our Services with care, based on our own experience and on what customers who share their time and feedback have experienced. However, there is no such thing as a service that pleases everybody. We make no guarantees that our Services will meet your specific requirements or expectations.

We also test all of our features extensively before shipping them. As with any software, our Services inevitably have some bugs. We track the bugs reported to us and work through priority ones, especially any related to security or privacy. Not all reported bugs will get fixed and we don't guarantee completely error-free Services.

## Services Adaptations and API Terms

We offer Application Program Interfaces ("API"s) for the Services. Any use of the API, including through a third-party product that accesses the Services, is bound by these Terms plus the following specific terms:

1. You expressly understand and agree that we are not liable for any damages or losses resulting from your use of the API or third-party products that access data via the API.
2. Third parties may not access and employ the API if the functionality is part of an application that remotely records, monitors, or reports a Service user's activity *other than time tracking*, both inside and outside the applications. The Company, in its sole discretion, will determine if an integration service violates this bylaw. A third party that has built and deployed an integration for the purpose of remote user surveillance will be required to remove that integration.
3. Abuse or excessively frequent requests to the Services via the API may result in the temporary or permanent suspension of your account's access to the API; the Company, in its sole discretion, will determine abuse or excessive usage of the API. If we need to suspend your account's access, we will attempt to warn the account owner first, but if your API usage could or has caused downtime, we may cut off access without prior notice.

Some third-party providers may create integrations between our Services and theirs. We are not liable or accountable for any of these third-party integrations.

## Use Restrictions

By using the Services, you acknowledge that you may not:

* Collect or extract information and/or user data from accounts which do not belong to you.
* Circumvent, disable, or otherwise interfere with security-related features of the Services.
* Trick, defraud, or mislead us or other users, including but not limited to making false reports or impersonating another user.
* Upload or transmit (or attempt to upload or to transmit) viruses or any type of malware, or information collection mechanism, including 1x1 pixels, web bugs, cookies, or other similar devices.
* Interfere with, disrupt, or create an undue burden on the Services or the networks or the Services connected.
* Harass, annoy, intimidate, or threaten others, or any of our employees engaged in providing any portion of the Services to you.
* Disparage, tarnish, or otherwise harm, in our opinion, us and/or the Services.
* Use the Services in a manner inconsistent with any applicable laws or regulations.

Accounts found to be in violation of any of the above are subject to cancellation without prior notice.

Violations can be reported by emailing [weave@grunion.ai](mailto:weave@grunion.ai) and should include detailed information about the account, the content or behavior you are reporting, and how you found it, including URLs or screenshots. We will not disclose your identity to anyone associated with the reported account.

## Liability

We mention liability throughout these Terms but to put it all in one section:

**_You expressly understand and agree that the Company shall not be liable, in law or in equity, to you or to any third party for any direct, indirect, incidental, lost profits, special, consequential, punitive or exemplary damages, including, but not limited to, damages for loss of profits, goodwill, use, data or other intangible losses (even if the Company has been advised of the possibility of such damages), resulting from: (i) the use or the inability to use the Services; (ii) the cost of procurement of substitute goods and services resulting from any goods, data, information or services purchased or obtained or messages received or transactions entered into through or from the Services; (iii) unauthorized access to or alteration of your transmissions or data; (iv) statements or conduct of any third party on the service; (v) or any other matter relating to these Terms or the Services, whether as a breach of contract, tort (including negligence whether active or passive), or any other theory of liability._**

In other words: choosing to use our Services does mean you are making a bet on us. If the bet does not work out, that's on you, not us.

If you have a question about any of these Terms, please contact us at [weave@grunion.ai](mailto:weave@grunion.ai).

---

Adapted from the Basecamp open-source policies ([github.com/basecamp/policies](https://github.com/basecamp/policies)), licensed [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
`;

export const SUPPORT = `# Support

weave is an open-source (MIT), self-hosted work platform in which AI agents are first-class users. The weave team takes support requests by email and on the public GitHub issue tracker.

## Bug reports

File bugs on the issue tracker at https://github.com/grunion-ai/weave/issues. Inside the app, the Report issue button files a bug report, and its Email instead option opens a prefilled email to weave@grunion.ai.

## Email support

Write to [weave@grunion.ai](mailto:weave@grunion.ai) with questions about weave or the hosted instance at https://weave.grunion.ai.

## Agent setup

The [Connect an agent](/docs) page covers the MCP URL, browser sign-in and the commands for Claude Code and other MCP clients.

## Source code and reference

The source is public at https://github.com/grunion-ai/weave. The full agent reference is in [AGENTS.md](https://github.com/grunion-ai/weave/blob/main/AGENTS.md).

## Privacy and terms

- [Privacy policy](/privacy)
- [Terms of Service](/terms)
`;

export const AGENT_DOCS = `# Connect an agent

{{ACCOUNT}}weave is an open-source (MIT), self-hosted work platform in which AI agents are first-class users. Workspaces hold spaces, spaces hold tables, and tables hold rows that link through relations and carry markdown documents. The MCP server, REST API, CLI and browser UI run the same engine.

## MCP URL

This instance serves MCP over streamable HTTP at this URL:

\`\`\`
{{MCP_URL}}
\`\`\`

The URL above serves one workspace. Another workspace on the same host is served at \`/w/<name>/mcp\`.

## Sign-in

The first call opens a browser sign-in (OAuth 2.1 with PKCE and dynamic client registration), so there is no token to paste. Any role on the workspace connects, and \`tools/list\` names only the tools that role may call: an Observer reads and comments, an Editor also creates, edits and deletes rows, and an Architect also changes the schema and accounts. Where the host bills for seats, creating and editing take a paid seat or an active free trial; without one, an Editor or Architect reads and comments as an Observer does.

## Claude Code

\`\`\`
claude mcp add --scope user --transport http weave {{MCP_URL}}
\`\`\`

## Other MCP clients

Claude, ChatGPT, Codex, Gemini CLI and any other client that supports remote MCP servers with OAuth take the same URL. Add {{MCP_URL}} as a remote server, then finish the browser sign-in on the first call.

## Self-hosted server over stdio

\`\`\`
claude mcp add weave -- node /path/to/weave/bin/weave.js mcp --data /path/to/workspace.db
\`\`\`

## First calls

Read the \`weave_ontology\` outline first. Then build the workspace in one \`weave_build\` call: run it with \`dryRun: true\`, then for real.

## Tool set

The server has 65 tools. By default it lists the 17 a workspace build uses, including \`weave_build\`, and \`weave_call\` runs any of the other 48 by name. A self-hosted server lists all 65 when started with \`weave mcp --tools all\` or with \`WEAVE_MCP_TOOLS=all\` set.

Every tool carries MCP annotations: a title, \`readOnlyHint\`, \`destructiveHint\`, \`idempotentHint\` and \`openWorldHint\`. A tool marked idempotent leaves the workspace unchanged when it is called again with the same arguments. Only the automation tools reach outside the workspace, because an automation rule can call a webhook URL. \`weave_call\` can run the automation tools, so it reaches outside the workspace too. A delete moves items to a trash, where they can be restored; a hard delete purges them.

## Reference and help

The full agent reference is in [AGENTS.md](https://github.com/grunion-ai/weave/blob/main/AGENTS.md). For questions and bug reports, see [Support](/support).

The table below lists each tool with its title and whether it is read-only or destructive.
`;