# Conflux MCP for AI Agents AI Agent Connect

> Conflux MCP lets your AI agent query the Conflux Network directly. Check CFX balances, inspect blocks on Core Space and eSpace, and monitor transaction receipts without leaving your workspace. It handles gas estimation and sponsorship details for smart contracts, making it a go-to for real-time blockchain auditing and developer workflows.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_QYHcelvzK7H6fQl0S40QxpBEKRdsGkTTxtS3s0Ra/ai-agent-connect
- **Tags:** conflux, web3, smart-contracts, blockchain-explorer, crypto-infrastructure

## Description

Instead of jumping between block explorers and manual spreadsheets, you can now have your AI agent pull live data from the Conflux Network. Whether you're trying to audit a specific account's state or need to see the transaction logs for a recent smart contract deployment, this Connector brings that data into your primary workspace. You can check balances across both Core Space and eSpace, get precise gas and collateral estimates before you commit to a transaction, and pull block details by hash or epoch. It's built for those who need to see the underlying ledger without the friction of constant tab-switching. By adding this to your setup via the Vinkius catalog, you turn your AI into a real-time blockchain oracle. You can track transaction receipts to debug execution errors or pull sponsorship info to see how contracts are being funded. It's about getting the raw numbers you need to make decisions, not just browsing a UI.

## Tools

### cfx_get_account
Get a summary of a Core Space account state. This helps you see the current status of an address quickly.

### cfx_get_balance
Get the CFX balance of an address on Core Space. Use this to check how much capital is available in a specific account.

### cfx_get_best_block_hash
Get the hash of the block with the highest weight. This helps you find the most recent data on the network.

### cfx_get_block_by_epoch_number
Get Core Space block details by epoch number. Use this to look up historical data from a specific time period.

### cfx_get_block_by_hash
Get Core Space block details by hash. This allows you to see every transaction inside a specific block.

### cfx_get_blocks_by_epoch
Get all block hashes in a specific Core Space epoch. Use this to gather a list of blocks for a certain timeframe.

### cfx_call
Execute a read-only contract call locally on Core Space. This lets you interact with smart contracts without spending gas.

### cfx_client_version
Get Conflux Core client version. Use this to verify that your node software is up to date.

### cfx_estimate_gas_and_collateral
Estimate gas and storage collateral for a Core Space transaction. This helps you avoid failed transactions due to insufficient funds.

### cfx_get_logs
Get Core Space logs matching a filter. Use this to find specific events or actions within a smart contract.

### cfx_get_next_nonce
Get next available nonce for a Core Space account. This ensures your next transaction won't conflict with previous ones.

### cfx_send_raw_transaction
Send a pre-signed raw transaction to Core Space. Use this when your own infrastructure handles the signing process.

### cfx_send_transaction
Send an unsigned transaction to the Core Space network. This works if your node is set up to manage the sender account.

### cfx_get_sponsor_info
Get sponsorship details for a Core Space contract. This shows you how a contract's gas and storage are being funded.

### cfx_get_status
Get current state of the Conflux Core node. Use this to check if your node is healthy and synchronized.

### cfx_get_transaction_by_hash
Get Core Space transaction details by hash. This provides a full look at the data for a specific on-chain move.

### cfx_get_transaction_receipt
Get Core Space transaction receipt. Use this to confirm if a transaction succeeded or failed.

### eth_get_balance
Get balance of an address on eSpace. Use this to check funds on the eSpace network.

### eth_get_block_by_number
Get eSpace block details by number. This helps you retrieve data from specific points in the eSpace history.

### eth_call
Execute a read-only contract call locally on eSpace. Use this to query smart contract data on eSpace.

### eth_estimate_gas
Estimate gas for an eSpace transaction. This helps you calculate costs before you submit a move on eSpace.

### eth_get_logs
Get eSpace logs matching a filter. Use this to find specific events on the eSpace network.

### eth_send_raw_transaction
Send a pre-signed raw transaction to eSpace. Use this for custom transaction signing on eSpace.

### eth_get_transaction_count
Get transaction count (nonce) for an eSpace address. Use this to find the next available nonce on eSpace.

### eth_get_transaction_receipt
Get eSpace transaction receipt. Use this to verify the outcome of an eSpace transaction.

## Prompt Examples

**Prompt:** 
```
What's the status of the Conflux node right now?
```

**Response:** 
```
I've checked the node status for you. Here are the current details:

| Metric | Value |
| :--- | :--- |
| **Current Epoch** | 124,502,312 |
| **Client Version** | conflux-rust/v2.3.0 |
| **Network Status** | Stable and Synchronized |

The node is currently healthy and up to date.
```

**Prompt:** 
```
Check the balance for cfx:aak2rra2njvd77ezwjvx74749399393939393939.
```

**Response:** 
```
I've retrieved the account information for that address:

*   **Balance:** 1,250.45 CFX
*   **Next Nonce:** 42
*   **Status:** Active in the staking system

Let me know if you need to check any other addresses.
```

**Prompt:** 
```
Give me the transaction details for block 0x8e5f...
```

**Response:** 
```
I've pulled the details for block **0x8e5f...**:

*   **Total Transactions:** 12
*   **Notable Activity:** Includes a contract call to the Sponsor system and several CFX transfers.

Would you like me to pull the full transaction list or a specific receipt for one of these?
```

## Capabilities

### Check account balances
Get the current CFX amount for any address on Core Space or eSpace.

### Inspect block data
Pull full transaction objects and details for specific blocks or epochs.

### Estimate gas costs
Calculate the required gas and storage collateral for upcoming transactions.

### Track transaction receipts
Retrieve execution logs to see if a transaction succeeded or failed.

### Audit smart contracts
Query sponsorship details and perform read-only contract calls.

### Monitor node status
Get real-time updates on client versions and network synchronization.

## Use Cases

### Debug a failed contract call
A developer asks the agent to check the receipt for a specific hash using `cfx_get_transaction_receipt` to see why a contract call failed and what the error log says.

### Check sponsorship levels
An analyst asks for the sponsorship details of a contract using `cfx_get_sponsor_info` to see how a specific smart contract is being funded.

### Audit account states
A user asks the agent to summarize the balance and nonce for a specific address using `cfx_get_account` to verify current holdings.

### Estimate deployment costs
A developer asks how much gas is needed for a new contract using `cfx_get_block_by_hash` to see the data for a specific move.

## Benefits

- Stop jumping between tabs by using `eth_get_balance` to check funds on the eSpace network.
- Save time on manual calculations by using `cfx_estimate_gas_and_collateral` to get precise costs before sending transactions.
- Speed up debugging by pulling execution logs with `cfx_get_logs` and `eth_get_logs` directly into your chat.
- Monitor network health easily with `cfx_get_status` and `cfx_client_version` to ensure your node is running correctly.
- Analyze historical data faster by using `cfx_get_blocks_by_epoch` to pull entire sets of block hashes at once.

## How It Works

The bottom line is you get live blockchain data directly in your chat interface without leaving your tools.

1. Subscribe to the Conflux MCP on Vinkius and get your unique connection details.
2. Paste your Conflux Core and eSpace RPC URLs into your client's configuration.
3. Ask your AI agent to pull balances, check block hashes, or estimate gas for specific addresses.

## Frequently Asked Questions

**Can I use Conflux MCP to check balances on both Core Space and eSpace?**
Yes, this Connector supports both networks. You can query balances for any address on either Core Space or eSpace within the same conversation.

**How does Conflux MCP help with smart contract debugging?**
It lets your agent pull transaction receipts and execution logs for specific hashes. This helps you see exactly why a contract call might have failed without manual searching.

**Does Conflux MCP provide gas estimation?**
Yes, it can calculate the required gas and storage collateral for transactions on Core Space. This helps you avoid failed transactions caused by insufficient funds.

**Can I use Conflux MCP to see who sponsors a contract?**
Yes, you can query the sponsorship details for any Core Space contract. It shows you the funding details for gas and storage.

**Is Conflux MCP good for data analysis?**
It's great for pulling historical block data and transaction logs. You can ask your agent to pull entire epochs of data for off-chain analysis.

**Can I send transactions with Conflux MCP?**
Yes, it supports sending both pre-signed raw transactions and unsigned transactions, depending on how your node is configured.

**How can I check the CFX balance of a specific Core Space address?**
Use the `cfx_get_balance` tool by providing the Conflux address. You can also optionally specify an epoch (like 'latest_state') to get the balance at a specific point in time.

**Can I see if a smart contract has gas or storage sponsorship?**
Yes! The `cfx_get_sponsor_info` tool returns the sponsorship details for any target contract address, showing who is covering the costs for users interacting with it.

**How do I get the latest state of the Conflux Core network?**
Run the `cfx_get_status` tool. It provides the current epoch number, block height, chain ID, and other essential metrics about the node's synchronization state.