convez.ai
MCP Server
Blockchainpreneur

actions-xyz-mcp

Blockchainpreneur/actions-xyz-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

Instalação

$npx convez-ai Blockchainpreneur/actions-xyz-mcp

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

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.

Demo: a meeting transcript pasted into the actions.xyz extractor, returning structured action items

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:

  1. A human-readable summary — numbered action items with priority, assignee, and due date.
  2. 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:

LimitValue
Extractions per day10 per IP (resets 24 h after first use)
Max transcript size20,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:

ConditionWhat the tool tells the agent
Empty transcriptAsks for actual transcript text (caught locally, no quota burned)
Transcript > 20k charsSays to split into chunks (caught locally, no quota burned)
429 rate_limitedDaily limit reached + when to retry (Retry-After)
503 extraction_unavailableService temporarily down — retry later, input is fine
500 extraction_failedTransient server failure — retry once
Network failure / timeoutEndpoint unreachable + how to point at another deployment

Configuration

Env varDefaultPurpose
ACTIONS_XYZ_BASE_URLhttps://actionsxyz.vercel.appBase 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

License

MIT

Ver o original no GitHub

Relacionados