Skip to main content
Glama

⚠️ Alpha Software — Vaultfire Protocol is in active development. Smart contracts are deployed on mainnet but have not been formally audited by a third-party security firm. Read-only tools are safe for any agent. Write tools interact with live contracts and transactions are irreversible. Use at your own risk. See LICENSE for warranty disclaimers.

@vaultfire/mcp-server

MCP server for Vaultfire Protocol

On-chain trust verification for any MCP-compatible AI. Works with Claude · Copilot · Cursor · Windsurf · Google ADK and more.

Deployed on Base · Avalanche · Arbitrum · Polygon.

npm version License: MIT


Quick Start

Claude Desktop

Add to your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "vaultfire": {
      "command": "npx",
      "args": ["-y", "@vaultfire/mcp-server"],
      "env": {
        "VAULTFIRE_CHAIN": "base"
      }
    }
  }
}

To enable write tools (register agents, create bonds), add your private key:

{
  "mcpServers": {
    "vaultfire": {
      "command": "npx",
      "args": ["-y", "@vaultfire/mcp-server"],
      "env": {
        "VAULTFIRE_CHAIN": "base",
        "PRIVATE_KEY": "your_private_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "vaultfire": {
      "command": "npx",
      "args": ["-y", "@vaultfire/mcp-server"],
      "env": {
        "VAULTFIRE_CHAIN": "base"
      }
    }
  }
}

Generic (npx)

# Read-only mode (no key needed)
npx @vaultfire/mcp-server

# With a specific chain
VAULTFIRE_CHAIN=avalanche npx @vaultfire/mcp-server

# With write tools enabled
PRIVATE_KEY=your_private_key npx @vaultfire/mcp-server

Install globally

npm install -g @vaultfire/mcp-server
vaultfire-mcp-server

Available Tools

Read-Only Tools (always available)

Tool

Description

vaultfire_verify_agent

Full trust verification: identity, bonds, Street Cred, reputation, bridge status

vaultfire_get_street_cred

Get Street Cred score (0-95) and tier

vaultfire_get_agent

On-chain identity data (URI, type, registration date, active status)

vaultfire_get_bonds

All partnership bonds for an address

vaultfire_get_reputation

Reputation data (average rating, feedback count, verified %)

vaultfire_discover_agents

Find agents by capability tags

vaultfire_protocol_stats

Protocol stats: total agents, bonds, bonded value, bridge sync

Write Tools (require PRIVATE_KEY env var)

Tool

Description

vaultfire_register_agent

Register an AI agent on-chain (ERC-8004)

vaultfire_create_bond

Create a partnership bond with economic stake

Warning: Write tools submit real transactions to mainnet. Transactions are irreversible.


Resources

The server exposes two MCP resources for protocol context:

URI

Description

vaultfire://chains

All 4 supported chains with contract addresses and chain details

vaultfire://scoring

Street Cred scoring formula and tier definitions


Configuration

Environment Variable

Required

Default

Description

VAULTFIRE_CHAIN

No

base

Chain to query: base, avalanche, arbitrum, polygon

PRIVATE_KEY

No

Private key for write tools (register, bond). Never commit this.

VAULTFIRE_RPC_URL

No

Custom RPC URL (overrides default for selected chain)


Street Cred Scoring

Street Cred is a composite trust score (0–95) computed from live on-chain data:

Component

Points

Condition

Identity Registered

30

Agent has ERC-8004 on-chain identity

Has Bond

25

At least one partnership bond exists

Bond Active

15

At least one bond is currently active

Bond Tier

0–20

Platinum (≥0.5 ETH) / Gold (≥0.1) / Silver (≥0.05) / Bronze (≥0.01)

Multiple Bonds

5

More than one bond (ecosystem participant)

Tiers:

Tier

Score Range

Description

Unranked

0

No on-chain trust signals

Bronze

1–30

Basic identity or minimal bond activity

Silver

31–55

Registered and bonded with some stake

Gold

56–75

Active bond with meaningful stake

Platinum

76–95

Multiple active bonds with significant stake


Supported Chains

Chain

Chain ID

Hub

Native Token

Base

8453

✅ Primary

ETH

Avalanche

43114

AVAX

Arbitrum

42161

ETH

Polygon

137

POL


Why Vaultfire

Feature

Vaultfire

AxisTrust

Cred Protocol

Okta XAA

AI Accountability Bonds

AI Partnership Bonds

On-chain, trustless

partial

Multi-chain (day one)

✅ (4)

Street Cred composite score

T-Score

C-Score

Belief-weighted governance

ERC-8004 compliant

Morals over metrics. Privacy over surveillance. Freedom over control. Making human thriving more profitable than extraction.

Core differentiators:

  1. AI Accountability Bonds — real economic skin-in-the-game, not just scores

  2. AI Partnership Bonds — mutual economic stakes between agents

  3. Belief-weighted governance — first in industry (not token-weighted)

  4. Cross-chain from day one — 4 mainnet chains

  5. Street Cred scoring — composite 0-95 trust score from on-chain data


Vaultfire Ecosystem

Package

Description

@vaultfire/agent-sdk

Core SDK — register agents, create bonds, query reputation

@vaultfire/langchain

LangChain / LangGraph integration

@vaultfire/a2a

Agent-to-Agent (A2A) protocol bridge

@vaultfire/enterprise

Enterprise IAM bridge (Okta, Azure AD, OIDC)

@vaultfire/mcp-server

This package — MCP server for Claude, Copilot, Cursor

@vaultfire/openai-agents

OpenAI Agents SDK integration

@vaultfire/vercel-ai

Vercel AI SDK middleware and tools

@vaultfire/xmtp

XMTP messaging with trust verification

@vaultfire/x402

X402 payment protocol with trust gates

@vaultfire/vns

Vaultfire Name Service — human-readable agent IDs

vaultfire-crewai

CrewAI integration (Python)

vaultfire-agents

3 reference agents with live on-chain trust

vaultfire-a2a-trust-extension

A2A Trust Extension spec — on-chain trust for Agent Cards

vaultfire-showcase

Why Vaultfire Bonds beat trust scores — live proof

vaultfire-whitepaper

Trust Framework whitepaper — economic accountability for AI

vaultfire-docs

Developer portal — quickstart, playground, framework picker


Security

  • Read-only tools require no credentials and are safe to run anywhere

  • Write tools require PRIVATE_KEY — always load from env vars, never hardcode

  • Smart contracts are deployed on mainnet but have not been formally audited

  • Transactions sent via write tools are irreversible

  • Do not expose your MCP server config (with PRIVATE_KEY) to untrusted parties


License

MIT — Copyright 2025 Ghostkey316

See LICENSE for full terms and warranty disclaimers.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - A tier

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

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

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/Ghostkey316/vaultfire-mcp-server'

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