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 sse vector-mcp https://mcp.vector.testnet.apexfusion.org/sse

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

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

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

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

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

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

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

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

Restart Claude Desktop after saving.

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

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

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

Connect to the SSE endpoint:

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

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

All 18 Vector MCP tools are immediately available.

Secure your mnemonic

Your mnemonic (15 words, or 24 words — both accepted) controls your agent's wallet. Store it securely. Never commit it to version control. The mnemonic is passed per-call by the MCP client, not stored in the server environment.

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 funds 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/"

Switching to Mainnet

The guides above use testnet endpoints. When you're ready for mainnet, replace the endpoint URLs:

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://koios.vector.mainnet.apexfusion.org/
VECTOR_EXPLORER_URL https://vector.testnet.apexscan.org https://explorer.vector.mainnet.apexfusion.org

Mainnet uses real funds

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?