alpha_amend_order
Edit an existing unfilled Alpha Arcade order in-place (change price, quantity, or slippage). Faster than cancel + recreate.
LABSCO SUMMARY
One server covers the whole Algorand round trip: construct a transaction, sign it with a key it owns, submit it, then read the result back.
The wallet tools are what separate this from an API wrapper — the server holds the signing key and never returns the mnemonic, so an agent can go from make_payment_txn to send_raw_transaction without a human pasting a signature. That also makes part of the surface financially live: make_http_request_with_x402 pays for the endpoint it calls, and alpha_cancel_order refunds tokens plus ~0.957 ALGO of collateral. Of the 119 tools, a large block is third-party — Tinyman, Haystack, Pera, NFD and Alpha Arcade each get their own set — so a reader who wants algod and indexer reads carries the rest in context alongside them.
What it is
A server over Algorand's algod and indexer APIs with a local agent wallet attached, 119 tools spanning key handling, transaction construction, simulation, chain queries and several third-party Algorand services.
What you get
- A wallet the server signs with: wallet_add_account stores an account under a nickname and keeps the mnemonic internally, wallet_switch_account picks the active signer, wallet_sign_transaction and wallet_sign_transaction_group sign with it and assign the group ID
- The transaction constructors as a family — make_payment_txn, make_asset_create_txn, make_asset_transfer_txn, make_app_call_txn and the rest — with assign_group_id, encode_unsigned_transaction and send_raw_transaction to get them on chain
- Two simulation paths before submission: simulate_transactions takes a full SimulateRequest config with execTraceConfig and extraOpcodeBudget, simulate_raw_transactions takes base64 bytes you already hold
- Algod and indexer reads side by side: account, asset and application state, application boxes, pending transactions and node status, plus indexer search over accounts, assets, applications and transaction history
- Key and encoding conversions: mnemonic to secret key or master derivation key and back, address encode, decode and validate, msgpack encode and decode, compile_teal and disassemble_teal
- Third-party Algorand services under the same server: NFD name records, Tinyman pool and swap quotes, Haystack routed swaps across Tinyman V2, Pact and Folks, Pera verification tiers, and Alpha Arcade prediction markets down to the orderbook
- x402 paid endpoints handled end to end — x402_discover_payment_requirements reads the accepts array without paying, make_http_request_with_x402 builds and signs the payment group, bazaar_list and bazaar_search browse the catalog of paid resources
Requirements
An Algorand account the server can hold the key for, created through wallet_add_account, and a network value on every call. The paying tools spend real balance: make_http_request_with_x402 draws USDC or ALGO from the active wallet, and the alpha_ order tools place live orders. MIT licensed.
Setup effort
One command — npm install -g @goplausible/algorand-mcp
USE CASES
01
Sending a payment from an agent-held account
Create an account the server keeps the key for, make it active, then build the payment, sign it locally and submit it. Nothing leaves the tool set for a human signature.
02
Checking what a contract call does before submitting it
Build the application call, then run it through simulation with execution traces and extra opcode budget before anything is signed. Reading the application's current state first tells you which arguments and boxes it expects.
03
Auditing what an address has been doing
Start from the current balance and holdings, then walk the history through indexer, and check whether an asset in the list is one Pera treats as verified before drawing conclusions from it.
04
Pricing a swap before committing to it
Compare a direct Tinyman quote against the route Haystack finds across Tinyman V2, Pact and Folks, check whether the wallet still has to opt into the asset, and do the opt-in first if it does.
05
Paying for an API the agent just found
Search the Bazaar catalog for a paid endpoint, read its payment requirements without paying to see the cost and the accepted assets, then make the call and let the wallet settle it.
119 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
alpha_cancel_order
Cancel an open Alpha Arcade order. Requires escrowAppId and orderOwner. Refunds USDC/tokens and ~0.957 ALGO collateral.
alpha_claim
Claim USDC from a resolved Alpha Arcade market by redeeming outcome tokens. Winning = 1:1 USDC.
alpha_create_limit_order
Place a limit order on an Alpha Arcade prediction market. Price and quantity in microunits (500000 = $0.50, 1000000 = 1 share). Locks ~0.957 ALGO collateral. Returns escrowAppId — save it for cancel_order.
alpha_create_market_order
Place a market order with auto-matching on Alpha Arcade. Price, quantity, and slippage in microunits. Returns escrowAppId, matched quantity, and actual fill price.
alpha_get_live_markets
Fetch all live Alpha Arcade prediction markets. Returns summary: id, title, marketAppId, prices, volume. Multi-choice markets have an options[] array — use options[].marketAppId for trading.
alpha_get_market
Fetch full details for a single Alpha Arcade prediction market. Pass marketAppId (numeric, always required) and optionally marketId (UUID) for richer API data.
alpha_get_open_orders
Fetch all open orders for a wallet on a specific Alpha Arcade market. Uses your active MCP wallet if walletAddress is not provided.
alpha_get_orderbook
Fetch the on-chain orderbook as a unified YES-perspective view. Merges all 4 sides (YES bids/asks + NO bids/asks). Includes spread calculation.
alpha_get_positions
Fetch all YES/NO token positions for a wallet across all Alpha Arcade markets. Uses your active MCP wallet if walletAddress is not provided.
alpha_get_reward_markets
Fetch Alpha Arcade markets with liquidity rewards (totalRewards, rewardsPaidOut, etc.). Same shape as alpha_get_live_markets but includes reward info. Requires ALPHA_API_KEY.
alpha_merge_shares
Merge equal YES and NO outcome tokens back into USDC on Alpha Arcade. 1 YES + 1 NO = 1 USDC.
alpha_propose_match
Propose a match between an existing maker order and your wallet as taker on Alpha Arcade.
alpha_split_shares
Split USDC into equal YES and NO outcome tokens on Alpha Arcade. 1 USDC (1000000 microunits) = 1 YES + 1 NO.
api_algod_get_account_application_info
Get account-specific application information from algod
api_algod_get_account_asset_info
Get account-specific asset information from algod
api_algod_get_account_info
Get current account balance, assets, and auth address from algod
api_algod_get_application_box
Get application box by name
api_algod_get_application_boxes
Get all application boxes
api_algod_get_application_by_id
Get application information
api_algod_get_asset_by_id
Get current asset information from algod
api_algod_get_node_status
Get current node status
api_algod_get_node_status_after_block
Get node status after a specific round
api_algod_get_pending_transaction
Get pending transaction information
api_algod_get_pending_transactions
Get all pending transactions
api_algod_get_pending_transactions_by_address
Get pending transactions for an address
api_algod_get_transaction_params
Get suggested transaction parameters
api_haystack_execute_swap
Execute an optimized token swap via Haystack Router — gets the best route across multiple DEXes (Tinyman V2, Pact, Folks) and LST protocols, then signs and submits the atomic transaction group using the active wallet account. This is an all-in-one tool: quote → sign → submit → confirm. All amounts are in base units (e.g., 1000000 = 1 ALGO).
api_haystack_get_swap_quote
Get an optimized swap quote from Haystack Router — a DEX aggregator that finds the best swap route across multiple Algorand DEXes (Tinyman V2, Pact, Folks) and LST protocols (tALGO, xALGO). Returns the best-price quote with route details, USD values, and price impact. Use this to preview a swap before executing. All amounts are in base units (e.g., 1000000 = 1 ALGO).
api_haystack_needs_optin
Check if an Algorand address needs to opt into an asset before swapping. Returns true if opt-in is needed, false otherwise. Always returns false for ALGO (ASA 0). Use before executing a swap to determine if wallet_optin_asset should be called first.
api_indexer_lookup_account_created_applications
Get applications created by this account
api_indexer_lookup_account_transactions
Get account transaction history
api_indexer_lookup_application_logs
Get application log messages
api_indexer_lookup_asset_balances
Get accounts holding this asset and their balances
api_indexer_lookup_asset_transactions
Get transactions involving this asset
api_indexer_lookup_transaction_by_id
Get transaction information by ID
api_indexer_search_for_accounts
Search for accounts with various criteria
api_indexer_search_for_applications
Search for applications with various criteria
api_indexer_search_for_assets
Search for assets with various criteria
api_indexer_search_for_transactions
Search for transactions with various criteria
api_nfd_browse_nfds
Browse NFDs with various filters
api_nfd_get_nfd
Get a specific NFD by name or by its application ID
api_nfd_get_nfd_activity
Get activity/changes for NFDs
api_nfd_get_nfd_analytics
Get analytics data for NFDs
api_nfd_get_nfds_for_addresses
Get NFDs for specific addresses
api_nfd_search_nfds
Search NFDs with various filters
api_pera_asset_verification_status
Get the verification status of an Algorand mainnet asset from Pera Wallet. Returns verification tier (verified, trusted, suspicious, unverified) and explorer URL.
api_pera_verified_asset_details
Get detailed information about an Algorand mainnet asset from Pera Wallet, including name, unit name, decimals, total supply, USD value, logo, verification tier, and collectible status.
api_pera_verified_asset_search
Search Pera Wallet verified Algorand mainnet assets by name, unit name, or keyword. Returns matching assets with verification status, USD value, and logo.
api_tinyman_get_asset_optin_quote
Get quote for opting into a Tinyman pool token
api_tinyman_get_liquidity_quote
Get quote for adding liquidity to a pool
api_tinyman_get_pool
Get Tinyman pool information by asset pair
api_tinyman_get_pool_analytics
Get analytics for a Tinyman pool
api_tinyman_get_pool_creation_quote
Get quote for creating a new Tinyman pool
api_tinyman_get_remove_liquidity_quote
Get quote for removing liquidity from a pool
api_tinyman_get_swap_quote
Get quote for swapping assets
api_tinyman_get_validator_optin_quote
Get quote for opting into Tinyman validator app
api_tinyman_get_validator_optout_quote
Get quote for opting out of Tinyman validator app
assign_group_id
Assign a group ID to a list of transactions
bazaar_get_resource_details
Fetch full details for a single Bazaar resource by its exact resource URL. Internally calls /discovery/resources?search=<url> and exact-matches against resourceUrl. Returns the verbatim resource record (accepts[], discoveryInfo / extensions, popularity counters) or an error if no match is found.
bazaar_list
Browse paid API resources cataloged in the Bazaar (the discovery directory hosted by the configured facilitator). Returns a compact summary per resource by default; pass full: true for the verbatim facilitator response. Supports filtering by network, method, merchantId, plus standard limit/offset pagination.
bazaar_search
Search Bazaar paid API resources by keyword. Hits the same /discovery/resources endpoint as bazaar_list but with the search query forwarded to the facilitator. Additional filters (scheme, maxUsdPrice, asset, payTo, extensions, includeTestnets) are applied client-side after the response. Defaults to mainnet-only.
bigint_to_bytes
Convert a BigInt to bytes
bytes_to_bigint
Convert bytes to a BigInt
compile_teal
Compile TEAL source code
create_account
Create a new Algorand account
decode_address
Decode an Algorand address to a public key
decode_obj
Decode msgpack bytes to an object
decode_signed_transaction
Decode base64 signed transaction bytes back into a transaction object with signature details. Accepts the blob from sign_transaction or wallet_sign_transaction.
decode_uint64
Decode bytes to a uint64
disassemble_teal
Disassemble TEAL bytecode back to source
encode_address
Encode a public key to an Algorand address
encode_obj
Encode an object to msgpack format
encode_uint64
Encode a uint64 to bytes
encode_unsigned_transaction
Encode a transaction object into base64 unsigned transaction bytes (msgpack). Accepts output from make_*_txn or assign_group_id.
generate_algorand_qrcode
Generate an Algorand URI and QR code according to ARC-26 specification
get_application_address
Get the address for a given application ID
get_knowledge_doc
Get markdown content for specified knowledge documents
make_app_call_txn
Create an application call transaction
make_app_clear_txn
Create an application clear state transaction
make_app_closeout_txn
Create an application close out transaction
make_app_create_txn
Create an application creation transaction
make_app_delete_txn
Create an application delete transaction
make_app_optin_txn
Create an application opt-in transaction
make_app_update_txn
Create an application update transaction
make_asset_config_txn
Create an asset configuration transaction
make_asset_create_txn
Create an asset creation transaction
make_asset_destroy_txn
Create an asset destroy transaction
make_asset_freeze_txn
Create an asset freeze transaction
make_asset_transfer_txn
Create an asset transfer transaction
make_http_request_with_x402
Call an x402-protected HTTP endpoint with automatic USDC/ALGO payment from the active wallet. If paymentRequirements is not supplied, this tool runs discovery internally (one extra request). Builds an atomic 2-transaction group (facilitator fee-payer + wallet payment), signs the payment leg with the wallet, and resends with the PAYMENT-SIGNATURE header.
make_keyreg_txn
Create a key registration transaction
make_payment_txn
Create a payment transaction
mdk_to_mnemonic
Convert a master derivation key to a mnemonic
mnemonic_from_seed
Generate a mnemonic from a seed
mnemonic_to_mdk
Convert a mnemonic to a master derivation key
mnemonic_to_secret_key
Convert a mnemonic to a secret key
ping
Basic protocol utility to verify server connectivity
rekey_account
Rekey an Algorand account to a new address
secret_key_to_mnemonic
Convert a secret key to a mnemonic
seed_from_mnemonic
Generate a seed from a mnemonic
send_raw_transaction
Submit signed transactions to the Algorand network
sign_bytes
Sign bytes with a secret key
sign_transaction
Sign a transaction with a secret key
simulate_raw_transactions
Simulate already-encoded, optionally-signed transactions (base64 bytes). Use this when you have raw txn bytes ready and only need a pass/fail + log/cost result — no execution tracing, no extra opcode budget, no unnamed-resource handling. For a richer simulation (trace, extra budget, unsigned txns, multiple groups), use simulate_transactions.
simulate_transactions
Simulate one or more transaction groups built from decoded transaction objects, with a full SimulateRequest config (allowEmptySignatures, allowMoreLogging, allowUnnamedResources, execTraceConfig, extraOpcodeBudget, round). Use this when you need execution traces, extra opcode budget, to simulate unsigned txns, or to opt into Algorand v9+ simulate features. For a quick pass/fail check on pre-encoded bytes, use simulate_raw_transactions instead.
validate_address
Check if an Algorand address is valid
verify_bytes
Verify a signature against bytes with an Algorand address
wallet_add_account
Create a new Algorand account, store it in the agent-wallet database with a nickname, and auto-switch to it if it is the first account. Returns address, public key, nickname, and index. The mnemonic is held internally by the MCP server and never returned to the agent.
wallet_get_assets
Get all ASA holdings for the ACTIVE wallet account (an account whose private key this MCP server owns). Returns the wallet nickname, address, network, and the assets array. Use this when listing holdings of "the wallet you control." For asset holdings of an arbitrary on-chain account, use api_algod_get_account_info (returns full account including assets) or api_algod_get_account_asset_info (single asset).
wallet_get_info
Get info for the ACTIVE wallet account (an account whose private key this MCP server owns in the OS keychain). Returns nickname, address, public key, network, on-chain balance, min-balance, opted-in apps/assets counts. Use this when you want to know the state of "the wallet you control." For an arbitrary on-chain account that this wallet does NOT own, use api_algod_get_account_info instead.
wallet_list_accounts
List wallet accounts with their nicknames and addresses. By default returns only ACTIVE accounts (signable). Pass { archived: true } to return ARCHIVED accounts instead — these are accounts whose mnemonic could not be recovered from the OS keychain at startup (e.g., wallet.db moved to a new machine without keychain, or fresh Docker install over an existing DB). Archived rows stay in the DB for forensics but cannot sign; their nicknames are freed for reuse by new active accounts.
wallet_optin_asset
Opt the active wallet account into an asset by ID. Creates, signs, and submits the opt-in transaction.
wallet_remove_account
Remove an Algorand account from the wallet by nickname or index.
wallet_sign_data
Sign arbitrary data with the active wallet account using raw Ed25519 (noble library, no Algorand SDK prefix). Returns hex signature.
wallet_sign_transaction
Sign a single transaction with the active wallet account.
wallet_sign_transaction_group
Sign a group of transactions with the active wallet account. Assigns group ID automatically.
wallet_switch_account
Switch the active wallet account by nickname or index. The active account is used for signing and balance queries.
x402_discover_payment_requirements
Probe an x402-protected HTTP endpoint and return its payment requirements (the accepts array from the 402 response) without paying. Use this to inspect cost and supported networks/assets before calling make_http_request_with_x402.
BEFORE YOU INSTALL
What to know first
Tools you get
119 tools when we connected.
Requires
- npx on PATH
- Node.js v20 or later
CONTEXT COST
Heavy Standing cost
Rated by the size of the 119 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @goplausible/algorand-mcpMCP Clients
OpenClaw
OPENCLAW · TERMINAL
npm install -g @goplausible/openclaw-algorand-pluginClaude Desktop, Cursor, Windsurf
JSON
{
"mcpServers": {
"algorand-mcp": {
"command": "npx",
"args": [
"@goplausible/algorand-mcp"
]
}
}
}Claude Code
CLAUDE CODE · JSON
{
"mcpServers": {
"algorand-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"@goplausible/algorand-mcp"
]
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"algorand-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"@goplausible/algorand-mcp"
]
}
}
}Cline
CLINE · JSON
{
"mcpServers": {
"algorand-mcp": {
"command": "npx",
"args": [
"@goplausible/algorand-mcp"
],
"disabled": false
}
}
}
