Skip to main content
Glama

AssetMCP

stdio Model Context Protocol server for UluOS: normalized ASA, ARC-200, and ARC-72 reads plus unsigned transaction payloads on Algorand mainnet and Voi mainnet.

Signing and broadcasting are intentionally out of scope—use UluWalletMCP and UluBroadcastMCP (or your wallet) after fetching base64 txn groups from this service.

Service summary (for UluOS docs)

Field

Value

Name

asset-mcp

Transport

stdio

Version

0.1.0

Networks

algorand-mainnet, voi-mainnet

Stack

@modelcontextprotocol/sdk, algosdk (ASA), ulujs → arccjs (ARC-200 / ARC-72 simulation)

Output

JSON text content; BigInts as strings; binary as base64; txn builders return ordered transactions: string[] (base64 unsigned bytes)

Related MCP server: Bankless Onchain MCP Server

Setup

npm install
npm start
# or: node /absolute/path/to/AssetMCP/index.js

Node: >= 20.9 (required by ulujs).

Configuration

Defaults use Nodely free-tier Algod + Indexer endpoints (Algorand mainnet: *.4160.nodely.dev; Voi mainnet: *.voi.nodely.dev). No API key required. Override with environment variables:

Pattern: ASSET_MCP_<NETWORK>_<SUFFIX> where <NETWORK> is ALGORAND_MAINNET or VOI_MAINNET, and <SUFFIX> is one of:

  • ALGOD_URL

  • ALGOD_TOKEN

  • INDEXER_URL

  • INDEXER_TOKEN

Example:

export ASSET_MCP_ALGORAND_MAINNET_ALGOD_URL="https://..."
export ASSET_MCP_ALGORAND_MAINNET_ALGOD_TOKEN="..."

Response shape

Successful tool calls return JSON:

{
  "ok": true,
  "network": "algorand-mainnet",
  "standard": "asa",
  "method": "asa_get_asset",
  "assetId": 31566704,
  "data": { }
}

Transaction builders add txCount and put base64 unsigned transactions under data.transactions (array order is the signing order).

Errors:

{
  "ok": false,
  "error": {
    "code": "malformed_address",
    "message": "...",
    "details": null
  }
}

Tools (by namespace)

asa_* (algosdk / AVM)

Tool

Purpose

asa_get_asset

ASA params by ID

asa_get_holding

One account’s balance / frozen flag for an ASA

asa_search_holdings

Indexer: paginated holdings; optional assetId filter

asa_transfer_txn

Unsigned axfer

asa_optin_txn

Unsigned opt-in (0-amount self transfer)

asa_closeout_txn

Unsigned transfer + closeRemainderTo (supply full amount)

arc200_* (ulujs ARC-200)

Tool

Purpose

arc200_get_metadata

name, symbol, decimals, totalSupply

arc200_balance_of

Balance (base units, string in JSON)

arc200_allowance

Allowance

arc200_has_balance

hasBalance (ulujs dual-ABI helper)

arc200_has_allowance

hasAllowance (ulujs dual-ABI helper)

arc200_get_events

getEvents → Transfer + Approval streams

arc200_transfer_txn

Simulated transfer → unsigned txn group

arc200_transfer_from_txn

Simulated transferFrom

arc200_approve_txn

Simulated approve

arc72_* (ulujs ARC-72)

Tool

Purpose

arc72_get_metadata

totalSupply; with tokenId: owner, tokenURI, approved; optional supportsInterface via interfaceSelectorHex

arc72_owner_of

Owner

arc72_balance_of

NFT count

arc72_get_approved

Approved address for token

arc72_is_approved_for_all

Operator flag

arc72_token_uri

Token URI

arc72_total_supply

Total supply

arc72_get_events

Transfer / Approval / ApprovalForAll

arc72_transfer_txn

transferFrom(from, to, tokenId) (signer must be authorized)

arc72_approve_txn

Approve spender for tokenId

arc72_set_approval_for_all_txn

setApprovalForAll via arccjs (ulujs wrapper is broken upstream)

Cursor MCP config

This repo includes .cursor/mcp.json so asset-mcp is available when you open the repo as the workspace folder. Reload the window or restart Cursor after changing it.

To add manually or merge into another project:

{
  "mcpServers": {
    "asset-mcp": {
      "command": "node",
      "args": ["${workspaceFolder}/index.js"]
    }
  }
}

Machine-readable capabilities

See examples/capabilities.json.

Live demo: from the repo root, npm run demo (or node examples/demo.mjs) spawns the MCP server over stdio and calls asa_get_asset (Algorand USDC), arc200_get_metadata (Voi wVOI), and arc72_total_supply (sample ARC-72 collection).

Implementation notes

  • stdout hygiene: ulujs / arccjs call console.log during simulation. Unless ASSET_MCP_DEBUG is set, console.log is redirected to stderr so MCP JSON-RPC on stdout stays valid.

  • ARC txn bytes: Built by simulating with simulate: true and returning the unsigned group from arccjs (txns array). Extra group transactions (e.g. box / resource-sharing) may appear—sign the full ordered group.

  • ARC-200 / ARC-72 reads: Use ulujs Contract with the public simulation sender (oneAddress from ulujs) for readonly ABI calls.

  • Event filters: address is forwarded to the indexer as sender (arccjs API).

  • ARC-72 setApprovalForAll: Implemented against contractInstance.arc72_setApprovalForAll because ulujs safe_arc72_setApprovalForAll references undefined variables (upstream bug).

License

MIT (see LICENSE).

Available Tools

29 tools
arc200_allowanceC

ARC-200 allowance(owner, spender) in base units.

Inputs: appId (required), owner (required), network (required), spender (required).

arc200_approve_txnB

Simulate ARC-200 approve(spender, amount); owner signs.

Inputs: appId (required), owner (required), amount (required), network (required), +1 more.

arc200_balance_ofA

ARC-200 balanceOf(address) as base units (string in response).

Inputs: appId (required), address (required), network (required).

arc200_get_eventsA

Fetch ARC-200 contract events (Transfer + Approval) via indexer (ulujs getEvents).

Inputs: appId (required), network (required), txid, limit, +4 more.

arc200_get_metadataA

Read ARC-200 name, symbol, decimals, and totalSupply (ulujs + simulation).

Inputs: appId (required), network (required).

arc200_has_allowanceA

ARC-200 hasAllowance(owner, spender) — allowance box present / non-zero (ulujs dual-schema read).

Inputs: appId (required), owner (required), network (required), spender (required).

arc200_has_balanceA

ARC-200 hasBalance(address) — whether the account has a non-zero balance box (ulujs dual-schema read).

Inputs: appId (required), address (required), network (required).

arc200_transfer_from_txnA

Simulate ARC-200 transferFrom(spender, from, to, amount); spender signs.

Inputs: to (required), from (required), appId (required), amount (required), +2 more.

arc200_transfer_txnA

Simulate ARC-200 transfer and return unsigned txn group as base64 strings (sign with UluWalletMCP).

Inputs: appId (required), amount (required), sender (required), network (required), +1 more.

arc72_approve_txnA

Simulate ARC-72 approve(approved, tokenId); owner signs.

Inputs: appId (required), owner (required), network (required), tokenId (required), +1 more.

arc72_balance_ofA

ARC-72 balanceOf(address) — number of NFTs owned.

Inputs: appId (required), address (required), network (required).

arc72_get_approvedC

ARC-72 getApproved(tokenId).

Inputs: appId (required), network (required), tokenId (required).

arc72_get_eventsA

Fetch ARC-72 Transfer, Approval, ApprovalForAll events (ulujs getEvents).

Inputs: appId (required), network (required), txid, limit, +4 more.

arc72_get_metadataA

Aggregate ARC-72 facts: totalSupply; if tokenId set, owner, tokenURI, approved; optional supportsInterface (8-hex selector).

Inputs: appId (required), network (required), tokenId, interfaceSelectorHex.

arc72_is_approved_for_allD

ARC-72 isApprovedForAll(owner, operator).

Inputs: appId (required), owner (required), network (required), operator (required).

arc72_owner_ofC

ARC-72 ownerOf(tokenId).

Inputs: appId (required), network (required), tokenId (required).

arc72_set_approval_for_all_txnB

Simulate ARC-72 setApprovalForAll(operator, approved). Uses arccjs directly (ulujs wrapper is broken). Owner signs.

Inputs: appId (required), owner (required), network (required), approved (required), +1 more.

arc72_token_uriA

ARC-72 tokenURI(tokenId) as UTF-8 string (null bytes stripped by ulujs).

Inputs: appId (required), network (required), tokenId (required).

arc72_total_supplyC

ARC-72 totalSupply().

Inputs: appId (required), network (required).

arc72_transfer_txnA

Simulate ARC-72 transferFrom(from, to, tokenId). Signer is sender (owner or approved operator).

Inputs: to (required), from (required), appId (required), sender (required), +2 more.

asa_closeout_txnA

Build an unsigned ASA transfer that closes the sender's holding (set closeRemainderTo). Supply full balance as amount.

Inputs: amount (required), sender (required), assetId (required), closeTo (required), +3 more.

asa_get_assetA

Load ASA configuration and on-chain parameters by asset ID (Algod).

Inputs: assetId (required), network (required).

asa_get_holdingA

Return one account's balance and frozen flag for an ASA (Algod account info).

Inputs: address (required), assetId (required), network (required).

asa_optin_txnA

Build an unsigned ASA opt-in (0-amount self transfer).

Inputs: sender (required), assetId (required), network (required), note.

asa_search_holdingsA

List ASA holdings for an account via Indexer (paginated). Optional assetId filter.

Inputs: address (required), network (required), limit, assetId, +1 more.

asa_transfer_txnA

Build an unsigned ASA transfer (axfer). Amount is in base units. Optional closeRemainderTo closes the sender holding after transfer.

Inputs: amount (required), sender (required), assetId (required), network (required), +3 more.

nt200_create_balance_box_txnA

Build unsigned NT200 createBalanceBox(address) txn(s). Creates a balance box for the specified address if it doesn't exist. May include payment txn for box creation cost. Uses ulujs CONTRACT + abi.nt200.

Inputs: appId (required), sender (required), address (required), network (required).

nt200_deposit_txnA

Build unsigned NT200 deposit(amount) txn(s). Deposit network token (payment) or ASA (axfer) preceding app call. For network: payment + app call; for ASA: set assetId for axfer + app call. Uses ulujs CONTRACT + abi.nt200.

Inputs: appId (required), amount (required), sender (required), network (required), +1 more.

nt200_withdraw_txnA

Build unsigned NT200 withdraw(amount) txn. Withdraws ARC-200 wrapped network tokens or ASAs; token holder must be opted in to the underlying asset. One txn (ulujs CONTRACT + abi.nt200).

Inputs: appId (required), amount (required), sender (required), network (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 29 tools

    Disambiguation5/5

    Each tool is unambiguously prefixed by its protocol (asa_, arc200_, nt200_, arc72_) and named after a specific action or query, so no two tools appear to target the same operation. Even similar functions like `balance_of` and `has_balance` have distinct meanings and clear descriptions. The grouping by asset type eliminates cross-protocol confusion.

    Naming Consistency5/5

    All tool names follow a strict lowercase snake_case pattern with a protocol prefix and a verb_noun or verb_txn suffix. Transaction builders consistently end in `_txn`, while queries use `get_`, `search_`, `has_`, etc., making the naming perfectly predictable across all 29 tools.

    Tool Count2/5

    With 29 tools, the server significantly exceeds the recommended 3-15 range for well-scoped MCP servers, and is above the 25+ threshold explicitly labeled as 'too many' in the rubric. While each tool serves a distinct purpose and covers multiple token standards, the sheer number is likely to overwhelm agents and increase selection complexity.

    Completeness5/5

    The tool set provides comprehensive coverage for each supported asset type: ASA queries, holdings, transfers, opt-in, and close-out; ARC-200 includes metadata, balances, allowances, approvals, transfers, and events; ARC-72 covers ownership, approvals, token URI, supply, transfers, and events. NT200 covers deposit, withdrawal, and balance box creation. Missing operations like asset creation are outside the apparent scope, so there are no critical gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers