AssetMCP
Provides tools to read ASA, ARC-200, and ARC-72 token data and generate unsigned transactions on the Algorand blockchain.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AssetMCP What is the asset info for ASA 31566704 on Algorand mainnet?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
|
Transport | stdio |
Version | 0.1.0 |
Networks |
|
Stack |
|
Output | JSON text content; BigInts as strings; binary as base64; txn builders return ordered |
Related MCP server: Bankless Onchain MCP Server
Setup
npm install
npm start
# or: node /absolute/path/to/AssetMCP/index.jsNode: >= 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_URLALGOD_TOKENINDEXER_URLINDEXER_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 params by ID |
| One account’s balance / frozen flag for an ASA |
| Indexer: paginated holdings; optional |
| Unsigned |
| Unsigned opt-in (0-amount self transfer) |
| Unsigned transfer + |
arc200_* (ulujs ARC-200)
Tool | Purpose |
|
|
| Balance (base units, string in JSON) |
| Allowance |
|
|
|
|
|
|
| Simulated transfer → unsigned txn group |
| Simulated |
| Simulated |
arc72_* (ulujs ARC-72)
Tool | Purpose |
|
|
| Owner |
| NFT count |
| Approved address for token |
| Operator flag |
| Token URI |
| Total supply |
| Transfer / Approval / ApprovalForAll |
|
|
| Approve spender for |
|
|
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/arccjscallconsole.logduring simulation. UnlessASSET_MCP_DEBUGis set,console.logis redirected to stderr so MCP JSON-RPC on stdout stays valid.ARC txn bytes: Built by simulating with
simulate: trueand returning the unsigned group fromarccjs(txnsarray). Extra group transactions (e.g. box / resource-sharing) may appear—sign the full ordered group.ARC-200 / ARC-72 reads: Use ulujs
Contractwith the public simulation sender (oneAddressfrom ulujs) for readonly ABI calls.Event filters:
addressis forwarded to the indexer assender(arccjs API).ARC-72
setApprovalForAll: Implemented againstcontractInstance.arc72_setApprovalForAllbecauseulujssafe_arc72_setApprovalForAllreferences undefined variables (upstream bug).
License
MIT (see LICENSE).
Available Tools
29 toolsarc200_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
Scored across 29 tools
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.
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.
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.
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
Related MCP Connectors
Provide AI agents and automation tools with contextual access to blockchain data including balance…
Query real-time blockchain token data across EVM and Solana networks. Access token balances, transfers, prices, holders, NFT ownership, DEX swaps, and liquidity pools. Supports Ethereum, Base, Arbitrum, BSC, Polygon, Solana, and more.
Read chain data on 200+ networks and Sui: transactions, logs, balances, objects, ABI-decoded.
Provenance and metadata tools for AI agents. Paid tools use x402 (USDC) at /mcp/<tool>.
Related MCP Servers
- AlicenseBqualityDmaintenanceFacilitates interaction with the Bitcoin network via the Model Context Protocol, enabling key generation, address validation, transaction decoding, and blockchain data retrieval.777MIT
- AlicenseBqualityDmaintenanceImplements the Model Context Protocol to allow AI models to access and interact with blockchain data, including reading contract states, retrieving events, and accessing transaction information across various networks.1078MIT
- -licenseNot gradedqualityNot gradedmaintenanceAn implementation that enables interaction with the Solana blockchain through the Model Context Protocol, supporting all actions from the Solana Agent Kit for standardized protocol operations.2-
- FlicenseNot gradedqualityDmaintenanceEnables AI applications to retrieve on-chain context from EVM-compatible blockchains via the Model Context Protocol.-