AstraSync MCP Bridge

Enable AstraSync's Identity, Trust and Verification capabilities through Model Context Protocol (MCP) - from account creation to agent registration, verification, and cryptographic signing.

What is this?

The AstraSync MCP Bridge connects AI assistants and development tools to the AstraSync AI Agent Registry. Through a single MCP integration, you can:

Create developer accounts - Sign up without leaving your AI assistant
Manage API credentials - Generate and manage API keys programmatically
Register AI agents - Add agents to the blockchain-based registry
Verify agent identity - Check registration status and trust scores
Generate crypto keypairs - Enable cryptographic signing for ownership proof

Think of it as complete identity infrastructure for AI agents, accessible through natural conversation.

Key Features

Universal Protocol: Works with any MCP-compatible platform via HTTP
Simple Setup: Quick self-hosted deployment with minimal configuration
Instant Integration: AI assistants can register agents during natural conversation
Real-time Compliance: Every agent gets a verifiable identity and trust score

Quick Start

Self-Hosted Setup

# Clone and install
git clone https://github.com/AstraSyncAI/astrasync-mcp-bridge.git
cd astrasync-mcp-bridge
npm install

# Configure environment
cp .env.example .env
# Edit .env if needed (defaults to production API at https://astrasync.ai/api)

# Start the bridge
npm start
# Or for development with auto-reload:
npm run dev

The bridge will run on http://localhost:3000 by default.

MCP Configuration

Once running, configure your AI assistant to use the bridge:

{
  "mcpServers": {
    "astrasync": {
      "url": "http://localhost:3000/mcp/v1",
      "transport": "http"
    }
  }
}

Test your setup: Visit http://localhost:3000/mcp/test for an interactive test interface.

Technical Implementation

Built with Official MCP SDK

The AstraSync MCP Bridge uses the official @modelcontextprotocol/sdk for automatic protocol compliance and future-proof compatibility.

Benefits:

✅ Automatic version negotiation - Supports latest MCP protocol (2025-06-18)
✅ Built-in transports - StreamableHTTP with SSE support included
✅ Standardized error handling - Proper McpError types
✅ Reduced maintenance - SDK handles protocol updates automatically
✅ Battle-tested - Used by all major MCP implementations

Dependencies:

{
  "@modelcontextprotocol/sdk": "^1.21.1",
  "express": "^4.21.2",
  "cors": "^2.8.5",
  "dotenv": "^16.4.7"
}

Why SDK over custom implementation?

The SDK saves ~22-30 hours of maintenance over 2 years:

Custom implementation: ~12-16 hours/year (protocol updates, bug fixes, testing)
SDK implementation: ~1 hour/year (dependency updates only)

Plus automatic compliance with future MCP spec changes.

Available Tools

Agent Management

`register_agent`

Register a new AI agent with AstraSync's compliance registry (requires authentication).

Required parameters:

agentName: Name of the AI agent
agentDescription: What the agent does
agentOwner: Name of the agent owner or company
email: Your AstraSync account email

Authentication (one required):

password: Your account password, OR
apiKey: Your AstraSync API key

Note: You must have an AstraSync account to register agents. Use create_account first if needed.

`verify_agent`

Verify if an agent is registered and compliant.

Required parameters:

agentId: The agent ID to verify

Account Management

`create_account`

Create a new AstraSync developer account.

Required parameters:

email: Email address for the account
password: Password (min 8 characters)
fullName: Full name of the developer
accountType: individual or business (optional, defaults to individual)

Returns: Account creation confirmation with dashboard link

`generate_api_key`

Generate a new API key for your AstraSync account.

Required parameters:

email: Account email address
password: Account password
keyName: Name/label for this API key

Returns: API key (save it securely - you won't see it again!)

Note: Requires existing AstraSync account (use create_account first)

`create_crypto_keypair`

Generate a crypto keypair for signing agent registrations.

Required parameters:

email: Account email address
password: Account password
keyName: Name/label for this keypair (optional)

Returns: Public key and confirmation that mnemonic was emailed

Tier limits:

Free tier: 1 crypto keypair
Developer tier: Unlimited keypairs

Note: Your mnemonic phrase will be sent to your email. Save it securely offline!