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.

This project has been archived.

The maintainers of this project have marked this project as archived. No new releases are expected.

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.6.0.tar.gz (21.5 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.6.0-py3-none-any.whl (22.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: actionlayer_mcp-0.6.0.tar.gz
  • Upload date:
  • Size: 21.5 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.6.0.tar.gz
Algorithm Hash digest
SHA256 b41cf3bfd515a3470585e7ecdb67d15edd273e3a3ffea16fc0941ef1b3c93638
MD5 c3094327283001ac0eb0a015bc5a04de
BLAKE2b-256 ffc57b3ac97c40b847cb9fdc26c47d73a36cbfb866fd8daefa516d08d2d02b06

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for actionlayer_mcp-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0d20bd54558ee147bcfa29a7f1b32e04cd02ee6c2983102e1332f86eb277d6dc
MD5 c7733e529004c7aed7525d90ecb93f80
BLAKE2b-256 0260069a58b884707c3b44f4d78f7682c227656e0d2084d07e9eff79b098c0e1

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