havona-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@havona-mcpShow me my recent trades"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 recent trade contracts |
| Fetch a trade by ID |
| Create a new trade contract |
| Update status (DRAFT → ACTIVE → COMPLETED) |
| Check chain connection + contract address |
| Get on-chain confirmation for a trade |
| List registered ERC-8004 AI agents |
| Get agent reputation score |
| List extractable ETR document types |
| Extract fields from a PDF (AI, no persistence) |
| Raw GraphQL passthrough |
Related MCP server: Armor Crypto MCP
Install
pip install havona-mcpOr 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_passwordClaude 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 clientsArchitecture
Claude Desktop / Cursor
│ MCP protocol (stdio or SSE)
▼
havona-mcp (this repo)
│ Python function calls
▼
havona-sdk
│ HTTPS + Bearer token
▼
Havona API → DGraph + Confidential EVMLicense
MIT — see LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for Gainium — manage trading bots, deals, and balances via AI assistants
MCP server for Mudrex futures trading enabling AI agents to securely access data and risk tools.
Related MCP Servers
- FlicenseBqualityFmaintenanceAn MCP server that enables AI models like Claude to interact with the Trading Simulator API for checking balances, viewing prices, and executing trades with automatic chain detection.15-

Armor Crypto MCPofficial
AlicenseCqualityCmaintenanceAn MCP server providing unified access to blockchain operations, bridging, swapping, and crypto trading strategies for AI agents.37179GPL 3.0- AlicenseCqualityDmaintenanceMCP server for TRON blockchain integration, enabling AI assistants to check balances, manage transactions, interact with smart contracts, and access real-time blockchain data.331MIT
- AlicenseAqualityDmaintenanceMCP server giving AI agents access to global supply chain and trade data from UN Comtrade, World Bank, and Open Supply Hub.5MIT