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:

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:

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:

Configuration

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

License

MIT