Regen Python MCP

You run an MCP server that exposes Regen Network’s blockchain data and tools through a standardized interface you can connect to with AI agents and custom apps. This server lets you query ecocredit types, track market activity, analyze portfolios, compare methodologies, and access on-chain modules, all in a consistent, programmable way.

How to use

Connect to the Regen Network MCP Server using a local (stdio) setup or an integration in a larger automation environment. You’ll run the Python-based server locally and then point your MCP client at the running process to list tools, call actions, and fetch data.

How to install

Prerequisites: Python 3.10 or higher, and pip.

Step by step install and run instructions.

# Clone the Regen Python MCP project
git clone https://github.com/gaiaaiagent/regen-python-mcp.git
cd regen-python-mcp

# Install dependencies
pip install -r requirements.txt

# Run the MCP server
python main.py

Configuration

Configure how you run the MCP server by setting environment variables as needed. The following example shows how you can configure the runtime to use alternative RPC/REST endpoints and enable basic caching. You can place these in a file named .env in the project root.

# Optional: Override default RPC endpoints
REGEN_RPC_ENDPOINTS=https://regen-rpc.polkachu.com,https://rpc.cosmos.directory/regen

# Optional: Override default REST endpoints
REGEN_REST_ENDPOINTS=https://regen-api.polkachu.com,https://rest.cosmos.directory/regen

# Optional: Enable caching
REGEN_MCP_ENABLE_CACHE=true
REGEN_MCP_CACHE_TTL_SECONDS=60

# Optional: Logging level
REGEN_MCP_LOG_LEVEL=INFO

Security and access

Run the server on a trusted host and limit access to the MCP endpoints to your AI agents or apps you control. If you enable caching or announce endpoints publicly, monitor for excessive usage and apply appropriate rate limiting.

Examples of use with an MCP client

Use a client that supports the MCP protocol to list available tools and execute actions. A typical workflow includes listing tools, querying credit types, and fetching market data.

Troubleshooting

If the server fails to start, verify you are using Python 3.10+ and that all dependencies install without errors. Check that the current working directory contains the project files and that you are running the correct entry point (main.py). If you encounter connectivity issues, confirm that the MCP client is configured to reach the local process and that any firewall rules permit the connection.

Available tools

list_accounts

List bank accounts and balances for a given address or all accounts when no address is provided.

get_account

Retrieve details for a specific bank account.

get_balance

Fetch the balance for a specific denomination in an account.

get_all_balances

Get all balances for an account, including multiple denoms.

get_spendable_balances

Return spendable balances for an account.

get_total_supply

Query the total supply for a given denomination.

get_supply_of

Return the total supply for a specific token/denomination.

get_bank_params

Fetch bank module parameters.

get_denoms_metadata

Retrieve metadata for all denoms.

get_denom_metadata

Fetch metadata for a single denom.

get_denom_owners

List owners of a given denom.

get_distribution_params

Query distribution module parameters.

get_validator_outstanding_rewards

Get rewards owed to a validator.

get_validator_commission

Fetch validator commission information.

get_validator_slashes

Retrieve validator slash events.

get_delegation_rewards

Query rewards for a delegation.

get_delegation_total_rewards

Total rewards for a delegation across all delegations.

get_delegator_validators

List validators for a delegator.

get_delegator_withdraw_address

Get the withdraw address for a delegator.

get_community_pool

Fetch the community pool data.

get_governance_proposal

Retrieve a governance proposal by ID.

list_governance_proposals

List governance proposals with filtering options.

get_governance_vote

Get a vote for a governance proposal.

list_governance_votes

List votes for governance proposals.

list_governance_deposits

List deposits for governance proposals.

get_governance_params

Query governance module parameters.

get_governance_deposit

Fetch a governance deposit by ID.

get_governance_tally_result

Retrieve tally results for a proposal.

get_sell_order

Fetch a single marketplace sell order.

list_sell_orders

List marketplace sell orders with pagination and filters.

list_sell_orders_by_batch

List sell orders for a specific credit batch.

list_sell_orders_by_seller

List sell orders by seller address.

list_allowed_denoms

List denoms allowed in marketplace transactions.

list_credit_types

List all ecocredit types available.

list_classes

List all ecocredit classes.

list_projects

List ecocredit projects.

list_credit_batches

List batches of ecocredits.

list_baskets

List baskets in the system.

get_basket

Retrieve a specific basket by ID.

list_basket_balances

List balances within a basket.

get_basket_balance

Get the balance for a specific basket item.

get_basket_fee

Fetch the basket fee information.

analyze_portfolio_impact

Analyze portfolio-level ecological impact.

analyze_market_trends

Analyze market trends across ecocredit types.

compare_credit_methodologies

Compare methodologies across credit classes.