Skip to main content

MCP server for ActionLayer — give Claude Code and other MCP hosts access to ActionLayer's typed action catalog.

Project description

actionlayer-mcp

MCP server for ActionLayer — give Claude Code (and any MCP host) access to ActionLayer's typed action catalog: 30+ actions across Gmail, Calendar, Drive, Slack, Notion, GitHub, Stripe, Linear, Resy, Partiful, USPS, and more.

Install

Get an API key at https://action-layer.dev/join, then:

claude mcp add --scope user actionlayer "uvx" "actionlayer-mcp" \
  --env ACTIONLAYER_API_KEY="ak_…" \
  --env ACTIONLAYER_API_URL="https://api.action-layer.dev"

Restart Claude Code and try:

Summarize my 3 most recent unread emails.

How it works

This package is a thin shim. The actual execution lives on ActionLayer's service. The MCP server here exposes one tool — actionlayer_invoke_action — plus helpers to list the catalog, create jobs, and manage the cyborg loop. Auth is via your bearer API key; the server proxies calls and surfaces the typed response back to your agent host.

Usage from other MCP hosts

# stdio transport (default)
actionlayer-mcp

# also works with Cursor, Cody, Codex, etc. — any MCP host

Env vars:

  • ACTIONLAYER_API_KEY — required, your bearer key
  • ACTIONLAYER_API_URL — defaults to https://api.action-layer.dev

Changelog

0.2.0

  • Async-by-default dispatch for browser actions. actionlayer_invoke_action now returns outcome="queued" + payload.ticket_id for browser actions instead of holding the connection open for minutes (the previous behavior hit gateway timeouts at 60s and triggered LLM retries that double-fired browser sessions).
  • New actionlayer_get_action_ticket(ticket_id) MCP tool — poll an action ticket until terminal. Returns is_terminal, outcome, output, live_view_url, etc.
  • Updated actionlayer_invoke_action docstring with explicit "DO NOT RETRY when outcome==queued" instructions for agent hosts.

0.1.0

  • Initial release. Six MCP tools: list_actions, get_action, invoke_action, create_job, get_job, cancel_job + legacy ticket tools.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

actionlayer_mcp-0.2.0.tar.gz (12.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

actionlayer_mcp-0.2.0-py3-none-any.whl (13.5 kB view details)

Uploaded Python 3

File details

Details for the file actionlayer_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: actionlayer_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 12.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.2

File hashes

Hashes for actionlayer_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 8864e65a3615ba7eb504e277ba17937896b162e8d2bdf18c9686fbc9172aee00
MD5 44efa2014570821caf38a00aab8f8c7c
BLAKE2b-256 6103044bc9dfe66be16eb039be2bbd94defbb2ad7ccaf97728126382a57f2c40

See more details on using hashes here.

File details

Details for the file actionlayer_mcp-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for actionlayer_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 628b84200c861564ddb2c20735de13d9d212ad49d6f38a6203d9802e462e8335
MD5 7816b8de0e344608742c11cdf6b70a71
BLAKE2b-256 c654556c601315a03dca7ffede79fca31fbc3861e934f8a34947a5c6c1a06ba0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page