actions-xyz-mcp
Blockchainpreneur/actions-xyz-mcp
Instalação
npx convez-ai Blockchainpreneur/actions-xyz-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
actions-xyz-mcp
MCP server for actions.xyz — give any MCP-capable agent (Claude, Cursor, Windsurf, …) the ability to extract structured action items from meeting transcripts and notes.

The same extraction pipeline the MCP tool calls, shown in the free web tool: paste a transcript → extract → structured action items.
It exposes one tool, extract_action_items, backed by the same extraction pipeline that powers the actions.xyz product (also available as a free web tool) — not a separate toy prompt.
What it does
extract_action_items({ transcript: string })
Sends your transcript to the public actions.xyz extraction API (POST /api/tools/extract) and returns:
- A human-readable summary — numbered action items with priority, assignee, and due date.
- Structured JSON:
{
"actions": [
{
"task": "Ship the MCP server package",
"description": "CONTEXT: ...\nSTEPS:\n1. ...",
"assignee": "Luis",
"assigneeType": "human",
"priority": "high",
"tag": "engineering",
"dueDate": "Friday"
}
],
"participants": ["Luis", "Ana"],
"remaining": 9
}
assigneeType is "human" or "agent", priority is "high" | "med" | "low", and remaining is your free-tier quota left today.
Quick start
Requires Node.js ≥ 18. No API key needed. The package is installed straight from GitHub (it is not on the npm registry yet):
npx -y github:Blockchainpreneur/actions-xyz-mcp
The server speaks MCP over stdio — it is meant to be launched by your MCP client, not run by hand.
Install in your client
Claude Code
claude mcp add actions-xyz -- npx -y github:Blockchainpreneur/actions-xyz-mcp
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"actions-xyz": {
"command": "npx",
"args": ["-y", "github:Blockchainpreneur/actions-xyz-mcp"]
}
}
}
Cursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in your project):
{
"mcpServers": {
"actions-xyz": {
"command": "npx",
"args": ["-y", "github:Blockchainpreneur/actions-xyz-mcp"]
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"actions-xyz": {
"command": "npx",
"args": ["-y", "github:Blockchainpreneur/actions-xyz-mcp"]
}
}
}
Rate limits (free tier)
The public endpoint is free and unauthenticated, with honest limits:
| Limit | Value |
|---|---|
| Extractions per day | 10 per IP (resets 24 h after first use) |
| Max transcript size | 20,000 characters per call |
When you hit the daily limit the tool returns a clear error with the retry window. Need more? Sign up free at actions.xyz for 5 full meetings a month.
Error handling
The tool maps every API error to a message the calling agent can act on:
| Condition | What the tool tells the agent |
|---|---|
| Empty transcript | Asks for actual transcript text (caught locally, no quota burned) |
| Transcript > 20k chars | Says to split into chunks (caught locally, no quota burned) |
429 rate_limited | Daily limit reached + when to retry (Retry-After) |
503 extraction_unavailable | Service temporarily down — retry later, input is fine |
500 extraction_failed | Transient server failure — retry once |
| Network failure / timeout | Endpoint unreachable + how to point at another deployment |
Configuration
| Env var | Default | Purpose |
|---|---|---|
ACTIONS_XYZ_BASE_URL | https://actionsxyz.vercel.app | Base URL of the actions.xyz deployment to call (useful for self-hosted or local instances) |
Development
git clone https://github.com/Blockchainpreneur/actions-xyz-mcp
cd actions-xyz-mcp
npm install
npm run build # tsc → dist/
npm test # real stdio handshake + live tools/call smoke test
Built by an autonomous agent
This package was designed, built, and tested end-to-end by an autonomous coding agent as part of the actions.xyz build. Every step is on the public record: actions.xyz build log.
Links
- actions.xyz — the product
- Free action-item extractor — same pipeline, in the browser
- Build log — the autonomous engine's public ledger
- Model Context Protocol