# Allnodes MCP for AI Agents AI Agent Connect > Allnodes MCP lets you manage your staking, validators, and Web3 hosting infrastructure directly from any AI agent. It handles the heavy lifting of node maintenance, server provisioning, and security key management so you don't have to jump between different dashboards or CLI commands to keep your crypto stack running. It turns complex blockchain infrastructure into a simple conversation. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_pDWCp6EtFRt6bE9O0uTi9hDg7OoPxhITrh8Umr63/ai-agent-connect - **Tags:** staking, validators, web3, node-hosting, crypto-infrastructure ## Description Managing a blockchain infrastructure feels like a full-time job. You're constantly switching tabs to check on your validator's health, hunting for SSH keys to access your bare-metal servers, or trying to figure out if your staking rewards are actually hitting your wallet. It's a fragmented mess of dashboards and terminal commands that eats up your day. This Connector changes that by bringing your entire Allnodes account into your AI agent's reach. Instead of hunting for a specific dashboard, you just tell your agent what needs doing. It can check your staking positions, spin up new hosting environments, or perform maintenance tasks like restarting a node in seconds. You can manage your security keys and provision servers without ever leaving your chat interface. It turns a complex set of manual operations into a conversation. By connecting this through the Vinkius catalog, you get a centralized way to handle the plumbing of Web3 without the friction of constant context switching. You can see your full node metadata, check for available server upgrades, and perform deterministic registrations without ever needing to remember a specific API endpoint or a complex command string. It's about getting back to the actual work of building and investing while the agent handles the infrastructure overhead. ## Tools ### get_fullnodes Get all full nodes. This lists every full node you have currently running on the platform. ### get_instant_server_profiles Get all available Instant server installation profiles. This helps you see what operating systems and setups are ready for quick deployment. ### get_instant_server_upgrades Get all available Instant server upgrades. Use this to see how you can scale your current instant server resources. ### get_instant_servers Get all available Instant servers. This provides a complete list of your active instant server environments. ### get_servers Get all bare-metal servers. This lets you view your high-performance bare-metal hardware in one list. ### get_ssh_keys Get all SSH Keys. This allows you to see every public key currently associated with your account. ### get_validators Get all validators. Use this to see a bird's eye view of all your active validator nodes. ### host_instant_server Host an Instant server. Use this to spin up a new instant server environment with a single command. ### host_node Host a validator or masternode. This provisions a new node for specific currencies like ETH, SOL, or DOT. ### prepare_deterministic Prepare deterministic registration. Use this to start the process for a deterministic node registration. ### remove_ssh_key Remove an SSH Key. This lets you delete old or unused keys to keep your security profile clean. ### remove_validator Remove a validator. This lets you decommission and remove a validator from your active list. ### restart_fullnode Restart a full node. Use this to trigger a reboot for a specific full node when it needs a refresh. ### staking_action Perform a staking action. Use this to stake, unstake, withdraw, or claim rewards for various currencies. ### submit_deterministic Submit deterministic registration. Use this to finalize and submit your deterministic registration details. ### get_delegation Get a specific delegation. This fetches the details for a single staking delegation you want to inspect. ### get_delegations Get all delegations. Use this to see every staking delegation across your entire Allnodes account. ### get_fullnode Get a specific full node. This retrieves the metadata and status for one specific full node. ### add_ssh_key Add a new SSH Key. Use this to quickly register a new key for secure terminal access to your nodes. ### get_validator Get a specific validator. This pulls the current status and rewards for a single validator. ## Prompt Examples **Prompt:** ``` List all my bare-metal servers on Allnodes. ``` **Response:** ``` I've retrieved your bare-metal servers. You currently have 2 active servers: | Server Name | ID | Status | | :--- | :--- | :--- | | Main-ETH-Node | srv-8821 | Active | | Backup-Validator | srv-9932 | Active | Would you like to see the specifications for either of these? ``` **Prompt:** ``` What installation profiles are available for instant server ID 'srv-123'? ``` **Response:** ``` Checking profiles for srv-123... I found 3 available profiles: * **Ubuntu 22.04 LTS** * **Debian 11** * **CentOS Stream 9** Which one would you like to use for your new deployment? ``` **Prompt:** ``` Get the details for my validator with ID 'val-888'. ``` **Response:** ``` Inspecting validator val-888... This is an Ethereum validator. * **Status:** Active * **Uptime:** 99.9% * **Current rewards:** 1.2 ETH Would you like to see the full metadata or perform a staking action for this validator? ``` ## Capabilities ### Check staking positions See your current staking rewards and positions across different networks instantly. ### Provision new servers Spin up new bare-metal or instant hosting environments using natural language. ### Manage validator health Monitor the status and uptime of your active validators in real time. ### Handle SSH keys Add or remove public keys to manage secure access to your hosted infrastructure. ### Restart nodes Trigger a restart for a specific full node to clear issues or perform maintenance. ### Query hosting profiles View available installation profiles and upgrades for your instant servers. ## Use Cases ### The Midnight Maintenance A node goes down at 3 AM. Use `restart_fullnode` to get it back up without waking up to log into a console. This saves you from having to manually troubleshoot at all hours of the night. ### The New Launch A dev wants to launch a new masternode. Use `host_node` to provision the correct hardware for a specific currency. The agent handles the complex field requirements for different currencies automatically. ### The Reward Audit An investor wants to see their total rewards. Use `get_delegations` and `get_validator` to get a summary of their positions. It gives them a clear picture of their portfolio without opening multiple tabs. ### The Security Sweep A DevOps lead needs to rotate keys. Use `remove_ssh_key` and `add_ssh_key` to update access for the team. This keeps the infrastructure secure while making the process way faster for the admin. ## Benefits - No more dashboard hopping: You can check your validator health and staking positions using `get_validators` and `get_delegations` in one place. This keeps you focused on your work instead of switching tabs. - Faster provisioning: Spin up new environments using `host_node` or `host_instant_server` without manual setup. You can get your infrastructure live in seconds by just telling your agent what you need. - Simplified maintenance: Run `restart_fullnode` or `remove_validator` instantly when things go wrong. It's a lot easier to keep your nodes running when you don't have to hunt for the right button. - Centralized security: Manage your access with `add_ssh_key` and `remove_ssh_key` right from your agent. You can keep your public keys organized and secure without manually updating configuration files. - Real-time staking updates: Use `get_delegations` and `staking_action` to monitor and move your assets. You get a clear view of your staking rewards and positions without leaving your chat window. ## How It Works The bottom line is you move from clicking through dashboards to just asking for what you need. 1. Plug in your Allnodes API token to connect your account to the Connector. 2. Ask your agent to check status or perform actions like hosting a node or checking staking. 3. Receive immediate confirmation or data summaries in your chat window. ## Frequently Asked Questions **Can I use the Allnodes MCP to manage my staking rewards?** Yes, the Allnodes MCP allows you to monitor your staking positions and perform actions like claiming or unstaking rewards through your AI agent. **How does the Allnodes MCP help with node hosting?** You can use it to provision new bare-metal servers or host instant servers for various Web3 currencies using simple natural language commands. **Can my AI agent restart nodes using the Allnodes MCP?** Yes, you can ask your agent to restart a specific full node whenever it needs maintenance or a refresh to get it back online. **Is the Allnodes MCP good for DevOps engineers?** It's a great tool for DevOps because it handles SSH key management and automated server provisioning, which are core parts of managing Web3 stacks. **How do I manage my validators with the Allnodes MCP?** The Connector lets you list all your active validators and inspect the specific status and rewards for any individual validator in your account. **Can I use the Allnodes MCP to provision bare-metal servers?** Yes, the Connector can query your available bare-metal servers and help you manage your high-performance hosting infrastructure. **Can I list my active validators across all networks?** Yes! Use the `get_validators` tool to retrieve a comprehensive list of all validators associated with your account, including their IDs and current status. **How do I add a new SSH key for my hosted servers?** Simply use the `add_ssh_key` action. You'll need to provide an alias for the key and the public key string itself to register it in your Allnodes profile. **Is it possible to restart a full node through the AI?** Yes. By using the `restart_full_node` tool with the specific Node ID, the agent can trigger a remote restart of your infrastructure.