Skip to main content
Glama
havona-labs

havona-mcp

Official
by havona-labs
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

havona-mcp

MCP server for the Havona trade finance API. Connect any MCP-compatible AI assistant to live trade contracts, blockchain status, and document extraction.

Tools

Tool

Description

list_trades

List recent trade contracts

get_trade

Fetch a trade by ID

create_trade

Create a new trade contract

update_trade_status

Update status (DRAFT → ACTIVE → COMPLETED)

blockchain_status

Check chain connection + contract address

get_trade_blockchain_record

Get on-chain confirmation for a trade

list_agents

List registered ERC-8004 AI agents

get_agent_reputation

Get agent reputation score

list_supported_document_types

List extractable ETR document types

extract_trade_document

Extract fields from a PDF (AI, no persistence)

graphql_query

Raw GraphQL passthrough

Related MCP server: Armor Crypto MCP

Install

pip install havona-mcp

Or from source:

git clone https://github.com/havona-labs/havona-mcp
cd havona-mcp
pip install -e .

Configuration

Copy .env.example to .env:

HAVONA_API_URL=https://api.yourdomain.com
AUTH0_DOMAIN=your-tenant.us.auth0.com
AUTH0_AUDIENCE=https://api.yourdomain.com
AUTH0_CLIENT_ID=your_client_id
HAVONA_EMAIL=trader@yourdomain.com
HAVONA_PASSWORD=your_password

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "havona": {
      "command": "python",
      "args": ["-m", "havona_mcp"],
      "env": {
        "HAVONA_API_URL": "https://api.yourdomain.com",
        "AUTH0_DOMAIN": "your-tenant.us.auth0.com",
        "AUTH0_AUDIENCE": "https://api.yourdomain.com",
        "AUTH0_CLIENT_ID": "your_client_id",
        "HAVONA_EMAIL": "trader@yourdomain.com",
        "HAVONA_PASSWORD": "your_password"
      }
    }
  }
}

Restart Claude Desktop. You can now ask:

"Show me my recent trades" "What's the blockchain status?" "Create a draft trade for 50,000 barrels of crude oil" "Extract the fields from this commercial invoice PDF"

Cursor / other MCP clients

python -m havona_mcp          # stdio (default)
python -m havona_mcp --sse    # SSE transport for web clients

Architecture

Claude Desktop / Cursor
        │  MCP protocol (stdio or SSE)
        ▼
  havona-mcp  (this repo)
        │  Python function calls
        ▼
  havona-sdk
        │  HTTPS + Bearer token
        ▼
  Havona API  →  DGraph + Confidential EVM

License

MIT — see LICENSE.

This server cannot be installed

A
license - permissive license
-
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • gainium-mcp

    MCP server for Gainium — manage trading bots, deals, and balances via AI assistants

  • mcp

    MCP server connecting AI agents to non-custodial staking data across 130+ networks.

  • Swagger MCP

    MCP server for AI access to Swagger by SmartBear.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/havona-labs/havona-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server