AgoraBLOCK
The digital town square where AI agents (PM/Architect/Coder/Tester) collaborate via group chat, while the human acts as the sole Leader. Built with TypeScript + DeepSeek Harness, featuring true parallel execution, cooperative preemption, MCP tools, and git worktree isolation.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
A human-led, group-chat workspace where AI agents plan, code, test, and review together.
Contents
- Current product
- Product demo
- What is Agora?
- Evidence and limits
- Architecture
- Quick Start (macOS)
- Tech Stack
- Repository Layout
- Roadmap
- Design Documents
- Project Status and Scope
Current scope: local use. Run Agora on your own computer and open its local address in your browser. The backend, Docker sandboxes, and Git worktrees run on that machine, and application data is stored locally. Cloud hosting is outside the current product scope. Model requests go to your chosen online API or local model service; local operation does not mean offline operation. The product installation and startup commands currently support macOS. The Linux product launcher and automatic credential setup are outside that task’s current scope; existing Linux sandbox support is separate.
Planned releases. Phase 10 is complete. Phases 11–13 will introduce Electron, a managed toolchain, and native Mac development, retiring Agora's Docker backend without legacy task migration. Phases 11 and 12 are limited previews; Phase 13 accepts the complete native workflow. These features are planned, not available in the current source build. The instructions below apply to the existing Docker-based implementation. See the roadmap for the smaller release milestones.
Credential setup on macOS. The local launcher creates a random encryption key in your macOS Keychain on first use and reuses it after restart. In the model settings dialog, enter your service's Base URL, API key, and model name, either for one Agent or the whole team. Keychain access may require macOS authorization. Existing encrypted connections remain unavailable when t
95c60c23749fOBSERVED · 2026-10-11Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add benchmark --env AGORA_CREDENTIALS_KEY=${AGORA_CREDENTIALS_KEY} --env AGORA_FIXED_FAKE_SECRET=${AGORA_FIXED_FAKE_SECRET} --env AGORA_GO_FORMAL_AUTHORIZATION=${AGORA_GO_FORMAL_AUTHORIZATION} --env AGORA_VALIDATION_KEYCHAIN=${AGORA_VALIDATION_KEYCHAIN} -- npx -y [email protected]{
"mcpServers": {
"benchmark": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"AGORA_CREDENTIALS_KEY": "${AGORA_CREDENTIALS_KEY}",
"AGORA_FIXED_FAKE_SECRET": "${AGORA_FIXED_FAKE_SECRET}",
"AGORA_GO_FORMAL_AUTHORIZATION": "${AGORA_GO_FORMAL_AUTHORIZATION}",
"AGORA_VALIDATION_KEYCHAIN": "${AGORA_VALIDATION_KEYCHAIN}"
}
}
}
}Exposed tools (18)
12 read · 6 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
applyPatch | read | |
check | read | |
createWorktree | read | |
diff | read | |
fs_read | read | Read task evidence. |
inspect | read | inspect |
list | read | |
merge | write | |
probe | read | Return a local diagnostic result |
read | read | |
read_audit | read | Read audit |
read_probe | read | Read the fixture file. |
run | write | |
sandbox_run | write | scripted trace fixture |
workspace_apply | write | |
workspace_read | read | |
workspace_run | write | |
write | write |
Trust audit
BLOCKgrade F · trust 51/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (8 observation(s))
- Network
- declared (6 observation(s))
- Shell
- declared (1 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (25)
...executables.map((path) => `(allow process-exec (literal ${quote(path)}))`),const origin = () => `http://127.0.0.1:${(server.address() as AddressInfo).port}`;payload: { secret: 'RAW_PAYLOAD_MUST_NOT_RENDER' },apiKey: 'startup-test-private-key',
const secret = 'test-model-private-key';
payload: { intent: 'forged', secret: 'never-trust-client-payload' },Agora-Natural-Chat-Artifact-2026-09-12.zip
0-output-resource-manifest.json.gz
0-output-service-manifest.json.gz
0-output-resource-manifest.json.gz
0-output-service-manifest.json.gz
atomic-invalid-payload-agora-task123-validation-q8aKKH.json
report.node=exec(res+'/node/bin/node',['--version']);report.pnpm=exec(res+'/node/bin/node',[res+'/pnpm/bin/pnpm.cjs','--version']);report.git=exec(res+'/git/bin/git',['--version']);
exec(res+'/git/bin/git',['init','-b','main',repo]);exec(res+'/git/bin/git',['-C',repo,'config','user.name','Spike']);exec(res+'/git/bin/git',['-C',repo,'config','user.email','[email protected]']);
report.node=exec(res+'/node/bin/node',['--version']);report.pnpm=exec(res+'/node/bin/node',[res+'/pnpm/bin/pnpm.cjs','--version']);report.git=exec(res+'/git/bin/git',['--version']);
exec(res+'/git/bin/git',['init','-b','main',repo]);exec(res+'/git/bin/git',['-C',repo,'config','user.name','Spike']);exec(res+'/git/bin/git',['-C',repo,'config','user.email','[email protected]']);
const repo = resolve(dirname(fileURLToPath(import.meta.url)), '../../..');
import { controlPath, keychainStore } from '../../web/scripts/local-process.mjs';const repo = fileURLToPath(new URL('../../../', import.meta.url));import { createGetChannels } from '../../../server/message-handlers';import { messageRuntime } from '../../../server/message-runtime';'.env' ... curl
'169.254.169.254',
new URL('https://metadata.google.internal/', 'https://registry.npmjs.org').href,Gates applied: no_behavioural_pass, no_license.
95c60c23749ffull audit observations/trust-audit/mcp-server/logan-suu__agora.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | 95c60c23749f | BLOCK | F | 51 | first audit |
Questions
What is the Agora MCP server?
The digital town square where AI agents (PM/Architect/Coder/Tester) collaborate via group chat, while the human acts as the sole Leader. Built with TypeScript + DeepSeek Harness, featuring true parallel execution, cooperative preemption, MCP tools, and git worktree isolation.
What tools does Agora expose?
18 in total: 12 read-only, 6 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Agora safe to connect to an agent?
No — not without reading the findings first. The audit graded it F (51/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on.
What credentials does Agora need?
It reads AGORA_CREDENTIALS_KEY, AGORA_FIXED_FAKE_SECRET, AGORA_GO_FORMAL_AUTHORIZATION, AGORA_VALIDATION_KEYCHAIN and DEEPSEEK_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does Agora run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as benchmark at 1.0.0.
How current is this page?
The grade is for one exact copy of the source (95c60c23749f), read on 2026-10-11. The repository is watched and re-audited when it changes.