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.0.tar.gz (19.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.5.0-py3-none-any.whl (20.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: actionlayer_mcp-0.5.0.tar.gz
  • Upload date:
  • Size: 19.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.5.0.tar.gz
Algorithm Hash digest
SHA256 43ceefabe04ed825b0145763af7a36147b5896f4160deb10956e9163ec8307dc
MD5 8d8888afe111342eb7d0351e084baa75
BLAKE2b-256 31cf9884ee11b416abd5c8db0a561f5d4f27903741b731839da1401fac24e9d2

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for actionlayer_mcp-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d5c835e1d851059b6bbc8dd8fe5085178b62bd9566f0a92112b115bd2a47818c
MD5 d88fa1fc4fc863dad59bc01f332ba0bc
BLAKE2b-256 e1bc87475bba689887f83bd1db3ca4dcefd3213c3ace34a96c546ca47141cf17

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