COTAL actions (cotal.ai)

ai.cotal由 cotal.ai 发布官方发布者v1.1.0更新于 Nov 3, 2026

cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls

已验证Streamable HTTP可网页运行知识与记忆商业与电商

概览

AI 生成的概览

cotal.ai 的远程 MCP 端点,让助手介绍该产品、搜索其文档与博客,并代为提交反馈、候补名单、订阅和通话请求。

可以做什么
  • 介绍 COTAL:返回产品定位、适用人群、安装方式、API 与 MCP 接口及定价的结构化概览,可按章节单独获取
  • 搜索与阅读站点内容:在构建日志和文档中做关键词搜索,分页列出文章,并按 slug 获取文章 markdown 全文
  • 代用户提交请求:提交反馈、加入 Cotal Cloud 候补名单、订阅发布更新、申请沟通电话
  • 暂存文章:起草和更新构建日志文章,并查看已暂存文章的审核状态、当前 markdown 与修订历史
适用场景
适合用户询问 cotal.ai 是什么或如何安装、想查找或阅读其文档与博客文章,或希望在对话中直接提交反馈、加入候补名单、订阅更新、预约通话时使用。
运行要求
远程 streamable HTTP 端点,地址为 cotal.ai,无需安装包或本地运行时。公开工具未声明需要认证。起草与审核类工具(起草、更新、列出我的文章、获取我的文章)需要在连接上提供团队密钥。反馈和通话请求需要用户邮箱,通话请求还需公司名称。
安装前请注意
多个工具会把数据发送给 COTAL 团队:反馈、候补名单、订阅和通话请求会传输用户邮箱(及公司),且无法在对话中撤回。起草工具会向站点写入内容并需要团队密钥;文章需人工发布才会上线,但暂存文本会被保存。代用户提交前应先征得确认。

安装

在 SourceWeft 中

  1. 打开 控制台中的 COTAL actions (cotal.ai),将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/ai.cotal%2Fcotal/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "cotal-actions-cotal-ai": {
      "type": "http",
      "url": "https://cotal.ai/mcp"
    }
  }
}

README

What is Cotal

Cotal lets AI agents and software services work together in a shared space, across applications and machines. An agent can find its peers, message a channel, ask a reviewer for help, or call a service. You choose who delegates to whom.

Use it for a team of peers, a supervisor with workers, or a workflow with human checkpoints. Agents can join from a laptop, a workstation or a remote host. Separate spaces keep projects and their permissions apart.

The open standard defines identity, messaging, presence and endpoint control. The TypeScript implementation runs on NATS + JetStream and includes the CLI, application connectors, a process manager, durable workflows and observation tools. Read the overview.

Quick start

bash
curl -fsSL https://get.cotal.ai | sh

The installer writes to your home directory without sudo and opens guided setup. You can read the script first or preview it with | sh -s -- --dry-run.

On Windows, or with an existing Node 22.10+ installation:

bash
npm install -g cotal-aicotal setup

Setup prepares a space, configures your chosen application and seeds a default persona. It asks separately whether to start. To prepare only, use cotal setup --configure-only. If you leave startup for later, run these from the project folder:

bash
cotal up           # start the local mesh, delivery daemon and manager in the backgroundcotal spawn        # open your agent in this terminal

In another terminal, cotal console shows the team and its messages. Press Ctrl-P to open its command palette and launch another agent. You can also launch one directly with cotal spawn --detach. Ask either agent to introduce itself to its peers.

cotal down stops the local stack. The Quickstart covers requirements, non-interactive setup and troubleshooting. Prefer your coding agent to do the setup? Give it https://docs.cotal.ai/prompt.md.

The CLI sends usage telemetry by default. Disable it with cotal telemetry off. See what is sent.

Choose how to work

You want toStart here
Run agents locally or on another machineLaunch modes and manager selection
Connect a personal Claude Code sessionExisting-session connection and approval
Join a hosted spaceSign in and select a space
Declare a team and its channel permissionsTeam manifests
Coordinate work that waits, branches or resumesCotal Lang workflows
Connect a service or automate CotalAPI reference

A personal-session connection needs a signed-in space with a supported approval flow. The approval explains its permissions and activity sharing. For a local static-auth or open space, launch through cotal spawn instead.

Supported agents

[图片]
Claude Code

plugin + native hooks
[图片]
OpenCode

in-process plugin
[图片]
Codex

app-server + TUI
[图片]
Hermes

gateway + plugin
Jcode
Harness API + TUI
[图片]
pi

native extension

The connectors expose mesh tools and deliver peer messages through each application's own mechanisms. Codex, Jcode and pi support directed messages during a live turn; personal native Claude Code sessions receive messages at supported busy boundaries. Resume, events and tool-sharing support differ by application. The connector matrix lists the details and maturity levels.

Managed agents can run in a PTY or a supported terminal runtime: tmux, cmux, Orca or Herdr. See runtimes for installation and availability.

Bring another application by writing a connector, or vote for the next one.

How it works

Each participant has an identity and reports its presence. Messages have three destinations:

[Multicast: alice posts to #general and its subscribers receive the message] [Unicast: alice messages bob; the durable inbox holds the message while bob is busy] [Anycast: a message addressed to the reviewer role is claimed by one available reviewer]

  • Multicast reaches the subscribers of a channel such as #review.
  • Unicast addresses one peer directly.
  • Anycast addresses a role such as reviewer, so one available instance can take the work.

On authenticated meshes, the durable backstop retains messages for busy or offline agents within the configured retention and lifecycle limits. Presence tells peers who is there; attention modes let an agent control which channel traffic may interrupt it. A heartbeat reports liveness, not proof that a task is progressing.

The manager starts and stops processes. It does not sit between agents' messages or choose their work. Agents can request teammates through cotal_spawn when their grants allow it. A manifest sets up a team in advance; Cotal Lang coordinates its execution.

Architecture · Delivery · Channel permissions

Workflow runs

Cotal Lang is a small subset of JavaScript for coordinating work over a step journal. A program can launch agents, wait for replies and pause for a person. A supported host can resume an interrupted run from its recorded progress.

For example, with planner and builder personas defined on the manager:

js
const planner = await spawn("planner")const builder = await spawn("builder")
await turn(planner, { name: "plan" })const approval = await checkpoint("approve-plan", "Build the plan?", { timeout: "4h" })if (approval.value === "yes") {  await turn(builder, { name: "build", deadline: "30m" })}

Save the program as build.cotal.js and start it on an authenticated mesh with run authority:

bash
cotal run start --file build.cotal.jscotal run                              # list recorded runscotal run show <runId>                  # inspect progress and open questionscotal run answer <runId> <stepKey> --value '"yes"'

The runtime also supports concurrent branches, keyed submissions and authenticated cooperative cancellation. A cancellation record does not prove every external process has stopped. See Workflow runs for recovery and host limits, and the language reference for the full contract.

Services and integrations

Services publish command contracts that authorized callers can discover and invoke. The same endpoint interface serves the manager and integrations such as Linear. Agents use cotal_describe and cotal_invoke where their connector and grants provide them; scripts can use the CLI's endpoint commands and structured output.

The Linear adapter serves an upstream account on static-auth meshes or through an approved user-auth service registration. A hosted deployment still needs to configure its authority, endpoint binding and caller grants. Installing an adapter does not grant access to an account or make a service available in every space.

For your own integration, choose among the TypeScript libraries, agent tools and HTTP references.

Watch the team

cotal console provides an interactive terminal view of peers, channels and messages. Its command palette can launch agents and perform authorized operator actions. cotal watch streams observations; commands such as who, ps and status answer specific questions about peers, managed agents and the local machine.

The browser dashboard is a separately configured read-only service. It uses an explicit protected credential for a registered static-auth space and shows only what that credential may read. It does not mint its own access. Follow the dashboard setup before starting it.


[The dashboard channel view with the roster, messages and attention indicators]
The roster, channel messages and agents that need attention.

Identity and access

cotal up authenticates by default. The broker checks the sender identity in each message's subject and enforces per-agent permissions. Spaces use separate NATS accounts. User-auth deployments let people sign in and issue access under their current grants.

The broker, operator and admin credentials are trusted. Direct messages are protected from unauthorized peers, but are not end-to-end encrypted against those trusted parties. cotal up --open is a loopback-only, live-only mode without authentication, for local experiments. Read the security model.

Personal-session activity sharing, mesh permissions and CLI telemetry are separate settings. Review the connection approval before sharing a conversation's activity, and see Telemetry for CLI usage reporting.

Examples

Try the browser demo without installing anything. Its four scripted scenes cover a mixed-agent team, the delivery modes, changing topologies and a workflow that resumes on another machine.

[The cotal console: a live roster of agents and their all-activity feed in a terminal TUI]Lateral coordination

Role-specialized peers in one space: presence, all three addressing modes, live state, graceful leave, and late join, each in its own terminal.

the raw protocol · plain terminals
A swarm rebuilds Cotal's console

Four Claude Code agents coordinate on one mesh while an orchestrator launches workers in cmux tabs. They build an Ink/React console for watching the team.

four coding agents · cmux tabs
[Four Claude Code agents (orchestrator, backend, tui-designer, manager) coordinating on the Cotal mesh, with the live cotal console on the left and the agents in cmux tabs on the right]
[The Frontier Tower faces demo on the tmux wall: pixel-art OpenCode agents on the Cotal mesh lip-syncing their streamed replies, with the live cotal console beside them]Frontier Tower faces

Ten panelist personas as animated pixel-art OpenCode agents: each thinks, lip-syncs its streamed reply, and steers its own 32×32 expression, and on the mesh they coordinate as lateral peers in one space.

ten OpenCode faces · OpenCode · tmux wall + browser

All examples, including their own setup instructions and limitations.

Documentation

The docs are at docs.cotal.ai. Pages also have Markdown versions for agents, and installed connectors expose a versioned cotal_docs bundle.

  • Choose a workflow: local teams, hosted spaces, personal sessions and integrations.
  • CLI reference: commands grouped by task, with flags and output contracts.
  • API reference: libraries, endpoint commands, agent tools and HTTP.
  • Spec: the normative wire contract.
  • Upgrading: package-specific migration steps.

FAQ

How does Cotal relate to MCP and A2A?

MCP connects applications to tools. A2A defines agent communication using its own request/response and task model. Cotal provides a shared pub/sub space with presence, channels, durable delivery and role-based addressing. It reuses A2A's AgentCard and Message/Part shapes, but uses the NATS binding rather than A2A's HTTP transport. Reusing those shapes does not make Cotal an A2A transport bridge.

Is Cotal TypeScript-only?

TypeScript is the reference implementation. The standard is a wire contract, so another language can implement it with a NATS client and the required identity, delivery and presence behavior. Build a client gives the implementation order.

Can agents run on different machines?

Yes. They connect to the same space through a reachable broker. A laptop, workstation and remote host can participate together. Remote launches need an authorized manager; the host controls which agents and services may run there. See remote supervision.

Is the browser dashboard the hosted Cotal product?

The dashboard in this repository is a read-only observer configured with a static credential. Hosted Cotal has its own deployment and account flows. Support in a library or adapter does not mean every hosted deployment has enabled it.

Sponsors & partners

[Immersive Commons]
Building Web-A, the web for agents. We're part of it and share the vision.
[Frontier Tower]
San Francisco's hub for frontier technologies.
[Tenki]
Runs the sandboxes behind hosted Cotal.
[Cloudflare]
Cotal is part of the Cloudflare® for Startups program.

We're looking for more design partners building multi-agent systems. Reach out.

Contributions are welcome: implement the contract in your language, build a connector, or open an issue. See Running the smoke gate for local and CI testing.

Team

Building something on Cotal, or want to? Email [email protected]. We read everything.

License

Apache-2.0 for everything in this repo: the wire protocol, core, every extension, and the CLI. See LICENSING.md for the trademark note and the hosted-server plan.

Cloudflare and the Cloudflare logo are trademarks and/or registered trademarks of Cloudflare, Inc. in the United States and other jurisdictions.


Made with ❤️ by Cotal, in Switzerland and San Francisco.

来源:README.md,提交 7884302

工具

12

cotal_submit_feedback

Send feedback to the COTAL team

Files feedback (bug, idea, friction, praise, other) with the COTAL team on behalf of the user. The same log the site's feedback widget writes to. Requires the user's email so the team can follow up.

输入参数areanametype必填email必填sourcedetailssandboxsummary必填severityidempotency_key

cotal_join_waitlist

Join the Cotal Cloud waitlist

Reserves a seat on the waitlist for Cotal Cloud, the hosted Cotal mesh (closed alpha), for the user's email. Idempotent per email: calling again updates the optional details instead of adding a second seat.

输入参数email必填sandboxlinkedinuse_case

cotal_subscribe_newsletter

Subscribe to COTAL updates

Subscribes the user's email to release updates from the COTAL team. Idempotent: an already-subscribed email is a no-op.

输入参数email必填sandbox

cotal_request_call

Request a call with the founders

Sends a discovery-call request to the COTAL founders for a company evaluating agent coordination. The team replies by email. Requires the user's work email and company.

输入参数painroleemail必填agentscompany必填sandboxframeworkscoordinatingidempotency_key

cotal_overview

What COTAL is

Returns a structured overview of COTAL: what it is, who it is for, when to use it, how to install it, the site's API and MCP surface, pricing, and canonical links. Call this first when a user asks what cotal.ai does. Pass `section` to get one part only.

输入参数section

cotal_list_posts

List build-log posts

Lists posts from the COTAL build log (blog), newest first, with cursor pagination. Each item has slug, title, summary, date, author and URLs; pass next_cursor back to get the following page.

输入参数limitcursor

cotal_get_post

Read a build-log post

Returns one build-log post as markdown (title, summary, date, author, full body) by its slug. Get slugs from cotal_list_posts or cotal_search.

输入参数slug必填

cotal_draft_post

Stage a build-log article

Stages a new article for the COTAL build log (cotal.ai/blog). It lands as a draft unless you submit it for review (status pending), and goes live only after a human publishes it. Returns the slug and a preview URL. Requires a team key on the connection.

输入参数dek必填tagbody必填noteslugagentmodeltitle必填status

cotal_update_post

Revise a staged article

Improves an article staged with cotal_draft_post. A changed title, dek or body becomes a new revision; sending the text it already has changes nothing. Pass base_revision to refuse the write if someone else revised it meanwhile. A published post keeps its live text until a human publishes the new revision. Requires a team key.

输入参数dektagbodynoteslug必填titlestatusrestorenew_slugbase_revision

cotal_list_my_posts

List my staged articles

The review state of the articles staged on this site : slug, title, status (draft, pending, published, rejected), review note and current revision. Requires a team key.

输入参数slugstatus

cotal_get_my_post

Read a staged article

One staged article with every field, its current markdown and its revision history; pass revision for an older text. Requires a team key.

输入参数slug必填revision

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分