ai-agent

mercury-agent

Name: mercury-agent
Author: cosmicstack-labs

Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.

3,438 stars+47★ this week355 forksTypeScriptUpdated 10/22/2026100% free · open source

What it does

Mercury‑Agent is a 24/7 AI assistant that runs as a CLI or Telegram bot, equipped with permission‑hardened tools and token‑budget controls.

When to use it

•You need an always‑on AI that can perform automated tasks (e.g., data fetch, email drafting) without building your own backend.
•You want a single command‑line interface that can be extended with custom tools while keeping strict permission limits.
•You prefer a low‑code way to expose the agent on Telegram or other messaging channels for your team or customers.

Ready-to-paste prompt

mercury-agent ask "Create a 3‑slide investor deck for a B2B AI SaaS that includes market size, problem statement, and go‑to‑market strategy, and export the result as a PDF"

Heads up: The agent will refuse to run any tool until you set a valid OpenAI API key and, for Telegram mode, a valid bot token in the `.env` file; missing or malformed keys cause the process to exit immediately.

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🔑 Needs an API key

Works after you add credentials — the setup agent will ask you for them.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/mercury-agent && curl -fsSL https://workflowstacks.com/api/skills/mercury-agent/claude-skill -o ~/.claude/skills/mercury-agent/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How mercury-agent works

Codeflow

Free to inspect

Mercury-agent is a very large TypeScript project (~115k lines across 501 code files). Setup is light: installs like a normal app — add your API keys. Reading the code is optional. Last commit this month, MIT license, has a test suite.

Size

Very large codebase

~115k lines · 501 code files · days to read — use, don't read

Setup

One-command install

Installs like a normal app — add your API keys. Reading the code is optional.

Runs on

Node.js

Needs API keys (.env)

TypeScript 89%MDX 6%CSS 2%JavaScript 1%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
src/index.ts
Where the program starts running
3
package.json
Dependencies and the commands it exposes
4
.env.example
The API keys and settings you must provide

What's in each folder

src/Core code — the actual logic331 files

ui/Frontend / UI83 files

docs/Documentation193 files

website/Project website93 files

scripts/Helper scripts14 files

patches/Patches1 files

.github/CI / automation (GitHub Actions)2 files

READMEHas testsDocumentedCI checksMIT licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🔑 Needs an API key

Works after you add credentials — the setup agent will ask you for them.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/mercury-agent && curl -fsSL https://workflowstacks.com/api/skills/mercury-agent/claude-skill -o ~/.claude/skills/mercury-agent/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

cosmicstack-labs

Language

TypeScript