Skip to main content

MCP server for ActionLayer — give Claude Code and other MCP hosts access to ActionLayer's browser-action catalog with per-session credential intake.

Project description

actionlayer-mcp

MCP server for ActionLayer — let Claude Code (and any MCP host) drive browser-based sites on your behalf.

Install

Get an API key from your ActionLayer dashboard at https://actionlayer.io, then:

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

Restart Claude Code and ask it to do something for you.

Usage from other MCP hosts

actionlayer-mcp

Works with Cursor, Cody, Codex, etc.

Env vars:

  • ACTIONLAYER_API_KEY — required
  • ACTIONLAYER_API_URL — defaults to https://api.actionlayer.io

Changelog

0.4.2

Internal taxonomy scrub. No behavior change; tool descriptions and next_action.prompt fallbacks rephrased so calling agents don't surface ActionLayer's internal terminology in their own user-facing text.

0.4.1

Payment-card approval flow (Phase 2 of the agent payments plan).

  • actionlayer_reply now accepts payment_approved: bool for tickets whose info_request includes payment_status. Users approve a charge against their card-on-file with one call.
  • actionlayer_get_task / actionlayer_next_action surface card_brand, card_last4, amount_usd, and payment_status on the info_request payload so an agent can prompt the user with "Approve $X.XX charge on your card ending ?"
  • The card PAN itself NEVER crosses the MCP boundary. The charge is completed against the user's card on file; the PAN never appears on agent-visible surfaces. This is by design per docs/agent_payments_plan.md.

0.4.0

Backwards-incompatible — public API taxonomy changed.

  • Ticket state collapses the in-flight phases into a single public value pending. Polling code that branched on the individual sub-phases (e.g. if state == "executing") must switch to state == "pending". Terminal states (completed, failed, cancelled) and blocked_on_user are unchanged.
  • live_view_url is no longer returned by the public tools (actionlayer_invoke_action, actionlayer_get_action_ticket). User-facing callers should drive the task via polling actionlayer_get_action_ticket and responding to blocked_on_user prompts.
  • actionlayer_invoke_action sync response now uses outcome="queued" (instead of outcome="blocked") when the task is taking longer than the sync window allows. Callers handling outcome need to add a queued branch: poll actionlayer_get_action_ticket for terminal state.
  • Terminal tickets now carry a free-text reason field summarising the outcome (derived from result.summary on completed, error on failed). Pre-existing result / error fields preserved for callers that want the raw structured payload.

0.3.1

  • Update default API URL to https://api.actionlayer.io (api.action-layer.dev still redirects, but the new host is the current canonical name).

0.3.0

  • Browser-only catalog. Per-session credential intake.

0.2.0

  • Async-by-default dispatch for browser actions + ticket polling tool.

0.1.0

  • Initial release.

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.5.1.tar.gz (20.7 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.5.1-py3-none-any.whl (21.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: actionlayer_mcp-0.5.1.tar.gz
  • Upload date:
  • Size: 20.7 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.5.1.tar.gz
Algorithm Hash digest
SHA256 258377ad5efd05a23e27de8b7867ab8bb5601f14c367ebe4025b96b6153a5fb2
MD5 71b9c9aeb91e6b0e88d12fc4daf4cd73
BLAKE2b-256 2fddc0748a26a2e7894e75bde8c1d1c52feb340bfd6bbb89dfc0f44b6ee40cc7

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for actionlayer_mcp-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 265af12b62cf8c29b58c05ae98312e8fc57e85b75ebae4b1dca3a22ce785feb3
MD5 1a4d89c9af738965b98c6a110830991e
BLAKE2b-256 7e4ca382de60bffae6a38a3175d63ff8202eb02f4a0108ce460e751aa432f1b5

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