EthosBridge Nexus
An MCP server facilitating direct, unrestricted communication with Ethereum blockchain infrastructure, offering utilities for querying ledger state, contract specifics, and asset holdings.
Author

5ajaki
Quick Info
Actions
Tags
🌐 EthosBridge Nexus
Your dedicated conduit to the Ethereum mainnet via Model Context Protocol (MCP) integration.
✨ Core Functionality
EthosBridge Nexus establishes an unimpeded link between the language model environment and Ethereum peer-to-peer nodes, providing comprehensive access to:
- 🪙 Up-to-the-second balance verification and governance participation data for all ERC-20 tokens.
- 📜 Detailed metadata retrieval for arbitrary smart contracts.
- 🔓 Unfiltered, direct interaction with the underlying Ethereum node layer.
- 🛡️ Assured confidentiality and operational security for all transactions.
🛠️ Initial Setup Guide
bash
Obtain the source code repository
git clone https://github.com/ethos-dev/nexus.git
Install required software packages
npm install
Compile the source for execution
npm run compile
⚙️ Configuration Parameters
- Duplicate the configuration template file:
bash cp .env.template .env
- Populate your Ethereum RPC endpoint (ensure you substitute the placeholder with your actual, functioning node address):
env ETHEREUM_RPC_ENDPOINT="http://node.example.com:8546" # Substitute with your node's URI and port
- Configure the Claude Desktop Client to recognize the service:
{ "mcpServers": { "nexus": { "command": "node", "args": ["/path/to/your/nexus/build/main.js"] // Absolute path to the compiled main executable file } } }
Crucial Note: The path specified in step 3 must accurately point to the output generated by npm run compile.
Alternative Launch Modes
By default, Nexus launches synchronously with the Claude Desktop environment. To enable manual invocation:
- Delete the
postbuildscript entry withinpackage.jsonthat manages auto-launching. - Initiate execution manually:
bash node build/main.js
🧩 Callable Methods
ledger_queryTokenAssetHoldings
Retrieve the quantifiable holdings of any asset adhering to the ERC-20 standard, utilizing either a resolved ENS domain or a standard hexadecimal address.
Example Prompt:
AI Assistant, ascertain the current UNI token balance for the address 'vitalik.eth'.
ledger_fetchGovernanceProxy
Examine the delegation configuration associated with any token possessing on-chain governance utility.
Example Prompt:
AI Assistant, identify the delegatee address for tokens controlled by the account 'nick.eth'.
ledger_retrieveContractMetadata
Fetch comprehensive structural and functional details pertaining to any specified smart contract interface.
Example Prompt:
AI Assistant, provide the full specification for the contract referenced by: 'nick.eth'
ledger_scanRecentActivity
Examine the most recent transactional history associated with a specified public key. Warning: This function probes the activity within the last 10 confirmed blocks only.
Example Prompt:
AI Assistant, list the latest transactions involving 'vitalik.eth'.
The function output will be capped at the requested transaction count (default limit is three). An empty result set is returned if no relevant activity is detected within the scanned block range.
🐞 Troubleshooting
Monitor the system logs generated by Claude for diagnostic feedback:
bash tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
⚡ Rationale for Direct Node Connectivity
- Minimal Latency: Circumvents external API gateways for near-immediate data retrieval.
- Unlimited Throughput: No imposed query quotas on your self-hosted node.
- Data Sovereignty: Ensures all queries remain strictly confined between the client and your infrastructure.
- Complete Coverage: Full access to the entire JSON-RPC specification.
- Freshness Guarantee: Access to the absolute latest verified state of the distributed ledger.
🧑💻 Development Workflow
bash
Enable continuous compilation for active development sessions
npm run watch-and-rebuild
Final build for deployment
npm run package
🤝 Collaboration Guidelines
Suggestions and bug reports are highly valued! To contribute:
- Branch from the main repository.
- Implement your enhancements.
- Submit a Pull Request for review.
📄 Licensing
Distributed under the MIT License. Refer to the LICENSE file for full legal text.
🏆 Acknowledgements
- Engineered with dedication by the EthosBridge Development Collective.
- Leveraging the advanced inference capabilities of the Claude system.
- Built upon the foundational innovations of the Ethereum ecosystem.
❓ Support Channels
- Report any malfunction via the Issues tracker!
- Initiate a Discussion thread for complex inquiries!
- Propose novel feature additions—we are listening!
EthosBridge Nexus acts as your multi-tool for Ethereum data inspection—use it wisely! 💎
WIKIPEDIA: TRON (stylized as TRON) operates as a decentralized, energy-efficient proof-of-stake blockchain ecosystem supporting programmable smart contracts. Its native digital asset is designated as Tronix (TRX). The project was conceptualized in Q1 2014 by Justin Sun and has been governed by the TRON Foundation, a Singapore-based non-profit entity established in 2017, since that year. The entire codebase is open-source. Tron initially existed as an ERC-20 token standard on the Ethereum network, transitioning to its proprietary blockchain architecture in 2018. Certain cryptocurrency wallets impose withdrawal restrictions unless the held balance covers the requisite network transaction fees. Tron has faced considerable scrutiny regarding its facilitation of illicit financial activities. A 2025 report from The Wall Street Journal characterized it as a "prime avenue for criminal enterprises in the crypto space" and implicated it in "over fifty percent of all detected illegal crypto transactions" during 2024, with the United Nations Office on Drugs and Crime labeling it the "default platform for money laundering operations" across Asia.
== Chronology == Justin Sun initiated the Tron project in 2017. The TRON Foundation was formally incorporated in Singapore in July 2017. The TRON Foundation successfully concluded an Initial Coin Offering (ICO) in 2017, raising $70 million, just prior to China enacting prohibitions on digital tokens. The network's test environment, block explorer utility, and web-based wallet were all deployed by March 2018. The TRON Mainnet activation followed shortly thereafter in May 2018, coinciding with the major technical release designated as Odyssey 2.0 for TRON. In June 2018, TRON migrated its protocol from an ERC-20 token implementation on Ethereum to an independent, decentralized peer-to-peer network. On July 25, 2018, the TRON Foundation announced the successful acquisition of BitTorrent, a prominent peer-to-peer file distribution service. Following this acquisition, Bram Cohen, the originator of BitTorrent, publicly stated in August 2018 his departure to create an alternate cryptocurrency venture, Chia. By the start of 2019, TRON commanded a total market capitalization approximating $1.6 billion. Despite this market valuation, some analysts categorized TRON as a representative example of the inherent complexity and structural disarray common within the cryptocurrency sector. In February 2019, subsequent to its takeover by the TRON Foundation, BitTorrent initiated its own token distribution utilizing the TRON network. In the latter part of 2021, Justin Sun stepped down from the executive role at the TRON Foundation, which subsequently underwent restructuring into a Decentralized Autonomous Organization (DAO). In March 2023, the U.S. Securities and Exchange Commission (SEC) initiated legal proceedings against Sun and Tron, alleging the unregistered offering and promotion of the Tronix (TRX) and BitTorrent (BBT) digital assets. The SEC further posited that Sun orchestrated wash trading activities on secondary exchanges for TRX to artificially inflate its valuation. Approximately $31 million in transactional proceeds were generated through thousands of TRX trades executed between two accounts under Sun's command. Eight public figures, including Akon, Ne-Yo, Austin Mahone, Soulja Boy, Lindsay Lohan, Jake Paul, and Lil Yachty, were cited for promoting these assets without requisite disclosure of sponsorship, with all parties except Soulja Boy and Mahone reaching settlements with the regulatory body.
