Getting started

Introduction

ROXI OS is the Reasoning-Oriented Execution Interface: a set of MCP servers that let an AI agent plan onchain actions, while your own wallet signs every one.

What ROXI OS is#

Large language models are good at working out what should happen onchain: which contract to call, how much to send, on which network. They should never hold the key that makes it happen. ROXI OS splits those two jobs.

  • The agent reasons. It reads your request and uses ROXI's tools to look up chains, encode token calls and compile contracts.
  • Your wallet decides. Anything that changes state is sent to MetaMask as a prompt. You read it and approve or reject it. The private key never leaves the wallet.

Each capability is a separate server built on the Model Context Protocol (MCP), so ROXI works with any MCP client, such as Claude Desktop, and you only enable the tools an agent needs.

The four servers#

metamask-mcpConnects your MetaMask wallet. Reads chain data and sends anything that needs a signature to your wallet.chainlist-mcpLooks up networks from Chainlist: chain IDs, RPC endpoints, explorers and native currencies.erc20-mcpEncodes ERC-20 transfers, approvals, mints and reads, ready for your wallet to sign or call.solc-mcpCompiles Solidity source into ABI and bytecode, ready to deploy.

What you can do#

  • Check balances, blocks, transactions and ENS names in plain language.
  • Send or approve ERC-20 tokens, with the exact transaction shown in your wallet before it goes out.
  • Write, compile and deploy a contract from a conversation.
  • Find a reliable RPC endpoint for a network without leaving the chat.
Tip. New here? The quick start gets all four servers running in Claude Desktop in a few minutes. Start on the Sepolia testnet so nothing you try costs real funds.

Next steps#

Quick startInstall the servers and run your first request.How it worksThe prepare-then-sign flow behind every action.Security modelWhat ROXI can and can't do with your wallet.Send ERC-20 tokensA complete walkthrough, tool call by tool call.

Prefer the source? Every server is open on GitHub under the MIT license, and the servers run locally on your machine through npx.