Skip to content

5-Minute Start

Get an AI agent talking to Vector blockchain in under 5 minutes.

Prerequisites

  • An MCP-compatible AI client (Claude Code, Claude Desktop, or any MCP client)

That's it - no installs needed. The Vector MCP server is hosted publicly.

Step 1: Connect to the MCP Server

The Vector MCP server is hosted and publicly available - no installation, no API keys, no configuration.

One command:

claude mcp add --transport http vector-mcp https://mcp.vector.mainnet.apexfusion.org/mcp

To make it available across all your projects, add --scope user:

claude mcp add --transport http vector-mcp https://mcp.vector.mainnet.apexfusion.org/mcp --scope user

claude mcp add --transport http vector-mcp https://mcp.vector.testnet.apexfusion.org/mcp

To make it available across all your projects, add --scope user:

claude mcp add --transport http vector-mcp https://mcp.vector.testnet.apexfusion.org/mcp --scope user

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "vector-mcp": {
      "type": "http",
      "url": "https://mcp.vector.mainnet.apexfusion.org/mcp"
    }
  }
}

{
  "mcpServers": {
    "vector-mcp": {
      "type": "http",
      "url": "https://mcp.vector.testnet.apexfusion.org/mcp"
    }
  }
}

Restart Claude Desktop after saving.

Go to Settings → Connectors → Add custom connector, then enter:

https://mcp.vector.mainnet.apexfusion.org/mcp

https://mcp.vector.testnet.apexfusion.org/mcp

Connect any MCP client that supports Streamable HTTP to the /mcp endpoint:

https://mcp.vector.mainnet.apexfusion.org/mcp

https://mcp.vector.testnet.apexfusion.org/mcp

All 24 Vector MCP tools are immediately available.

Step 2: Create Your Agent's Wallet

Your agent's wallet is a BIP39 mnemonic - 15 or 24 words, both accepted. Generate a fresh one with any BIP39 tool or a Cardano wallet (Eternl works), and use it only for this agent.

The mnemonic is passed per-call by the MCP client and never stored on the server. Once your agent has it, ask:

"What's my Vector wallet address?"

The agent calls vector_get_address and returns the address it derived from the mnemonic (it starts with addr1 - Vector uses the mainnet network ID on both networks).

Secure your mnemonic

Your mnemonic controls your agent's wallet. Store it securely. Never commit it to version control. On mainnet it controls real value - use separate mnemonics for testnet and mainnet.

Step 3: Fund Your Agent (Testnet)

Use the Vector Testnet Faucet to get testnet AP3X sent directly to your agent's wallet - no bridging required.

  1. Register at the Vector Faucet web UI (one-time, requires email verification)
  2. Get your API key (prefixed vf_) from the web UI after logging in
  3. Request AP3X via the API:
curl -X POST https://faucet.vector.testnet.apexfusion.org/faucet/request \
  -H "Content-Type: application/json" \
  -H "X-API-Key: vf_your_key_here" \
  -d '{"address": "YOUR_AGENT_ADDRESS", "amount": 10000000}'

Ask your agent for its address first:

"What's my Vector wallet address?"

The agent will call vector_get_address and return your testnet address (it starts with addr1 - Vector testnet uses mainnet network ID).

See the full faucet documentation for limits, SDK examples, and alternative funding methods.

Step 4: Start Using Vector

Your agent now has access to these tools:

Tool What it does
vector_get_balance Check wallet balance
vector_get_address Get receiving address
vector_get_utxos List unspent outputs
vector_send_apex Send AP3X (with spend limits)
vector_send_tokens Send native tokens
vector_dry_run Simulate a transaction
vector_get_transaction_history View recent transactions

Try asking your agent:

  • "What's my Vector balance?"
  • "Send 5 AP3X to addr1qz..."
  • "Show me my recent transactions on Vector"
  • "Dry-run sending 10 AP3X to addr1qz..."

Using the Python SDK Directly

If you prefer programmatic access without MCP:

pip install apex-fusion-agent-sdk

import asyncio
from vector_agent import VectorAgent

async def main():
    agent = VectorAgent(
        ogmios_url="https://ogmios.vector.testnet.apexfusion.org",
        submit_url="https://submit.vector.testnet.apexfusion.org/api/submit/tx",
        mnemonic="your fifteen word mnemonic phrase here ...",
    )

    # Check balance
    balance = await agent.get_balance()
    print(f"Balance: {balance.lovelace / 1_000_000} AP3X")

    # Get address
    address = await agent.get_address()
    print(f"Address: {address}")

    # Send AP3X
    result = await agent.send(to="addr1qz...", ada=5.0)
    print(f"Sent! TX: {result.tx_hash}")

asyncio.run(main())

You can also use environment variables instead of passing params directly:

export VECTOR_MNEMONIC="your fifteen word mnemonic phrase here ..."
export VECTOR_OGMIOS_URL="https://ogmios.vector.testnet.apexfusion.org"
export VECTOR_SUBMIT_URL="https://submit.vector.testnet.apexfusion.org/api/submit/tx"
export VECTOR_KOIOS_URL="https://v2.koios.vector.testnet.apexfusion.org/"

Testnet and Mainnet

Vector mainnet is live - the connect tabs above cover both networks. The sensible workflow: develop on testnet (free AP3X from the faucet), deploy to mainnet when your agent is ready (get mainnet AP3X). For SDK access, the endpoint pairs are:

Variable Testnet Mainnet
VECTOR_OGMIOS_URL https://ogmios.vector.testnet.apexfusion.org https://ogmios.vector.mainnet.apexfusion.org
VECTOR_SUBMIT_URL https://submit.vector.testnet.apexfusion.org/api/submit/tx https://submit.vector.mainnet.apexfusion.org/api/submit/tx
VECTOR_KOIOS_URL https://v2.koios.vector.testnet.apexfusion.org/ https://v2.koios.vector.mainnet.apexfusion.org/
VECTOR_EXPLORER_URL https://vector.testnet.apexscan.org https://vector.apexscan.org/en/

Mainnet uses real value

On mainnet, AP3X has real value. Start with small amounts, use conservative spend limits, and test thoroughly on testnet first. Use separate mnemonics for testnet and mainnet wallets.

The code and configuration are identical - only the endpoint URLs change.

What's Next?