JS-Peer x DeFi MCP Server

A Model Context Protocol (MCP) server that provides programmatic access to js-libp2p universal-connectivity functionality + DeFi Toolings, enabling AI assistants to interact with peer-to-peer networks, send messages, facilitate oracle networks coordination and all such over Libp2p as coordination layer.

Usage

Starting the MCP Server

1. Install dependencies:

npm install

2. Build the project (optional; npm start will build automatically):

npm run build

3. Start the MCP server:

npm start

• Connect with Claude Desktop App via Edit Config in File Navbar --> Settings --> Developer Tab or just press Ctrl + , to open settings menu and edit the config file in any IDE as below:

# Example claude_desktop_config.json
{
  "mcpServers": {
    "universal-connectivity": {
      "command": "node",
      "args": ["/absolute/path/to/js-peer-mcp/dist/index.js"],
      "env": {}
    }
  }
}

Related MCP server: Armor Crypto MCP

Skill definition (SKILL.md)

Claude Desktop loads skills from a SKILL.md file. This repo provides a ready-to-import skill definition:

• SKILL.md — skill definition that matches the tools exposed by this MCP server.

• claude-universal-connectivity-skill.json — same definition in pure JSON form.

To load the skill in Claude Desktop:

1. Open Skills in Claude Desktop.

2. Import or load SKILL.md from this repo.

3. After importing, you can call any of the listed tools from the skill.

• Close and Reopen the Claude Desktop App and a New Chat, you will now be able to view the universal-connectivity option in search and tools button of the input area.

ALWAYS ENSURE YOUR MCP SERVER IS RUNNING VIA npm start TO ACTIVATE THE JS-LIBP2P related operations

• Go ahead and chat with Claude for any libp2p related commands and it will present you with relevant results seamlessly! incredible, right?

Try this commands to get started:-

create libp2p node, 'start libp2p node', 'stop libp2p node', 'get node status'

• You can Further change permission access for this mcp-server through the left-bottom Your Account tab --> Settings --> Integrations --> universal-connectivity: tools and settings options:

DeFi Enhancements

The MCP server now includes comprehensive DeFi capabilities that leverage libp2p's peer-to-peer networking for decentralized finance applications:

DeFi Tools

Oracle Networks

• submit_oracle_data - Submit price/data feeds to decentralized oracle networks

• query_oracle_data - Query aggregated oracle data for assets

• Decentralized price feed aggregation without centralized providers

Cross-Chain Communication

• relay_cross_chain_message - Relay messages between different blockchain networks

• get_bridge_status - Monitor cross-chain bridge health and activity

• Fault-tolerant cross-chain communication infrastructure

Intent-Based DeFi

• submit_intent - Submit DeFi intents for solver coordination

• discover_intent_solvers - Find available solvers for intent execution

• Privacy-preserving intent propagation and MEV-resistant coordination

Decentralized Data Availability

• publish_da_data - Publish data to decentralized availability networks

• retrieve_da_data - Retrieve data with content addressing

• Trust-minimized data sharing for DeFi protocols

Keeper Networks

• register_keeper - Register automated keepers for DeFi operations

• coordinate_keeper_action - Coordinate liquidation, rebalancing, and harvest operations

• Decentralized automation without centralized coordination

DeFi Resources

• defi://oracle-data - Real-time oracle data feeds and aggregation

• defi://cross-chain-status - Cross-chain bridge status and relay information

• defi://intents-active - Active DeFi intents awaiting execution

• defi://keepers-network - Keeper network status and capabilities

• defi://da-data - Decentralized data availability catalog

Claude Skills Integration

This enhanced MCP server is designed to work seamlessly with Claude's skills system, providing AI-powered DeFi coordination capabilities.

Setting up Claude Skills

1. Load the DeFi Skill Configuration:

   # The claude-defi-skill.json file contains the skill definition
   # Import this into Claude's skills system

2. Skill Capabilities:

   • Oracle Network Management: Automated price feed submission and aggregation

   • Cross-Chain Coordination: Intelligent bridge management and message routing

   • Intent-Based Execution: AI-assisted intent creation and solver matching

   • Data Availability Management: Decentralized data publishing and retrieval

   • Keeper Network Orchestration: Automated DeFi operation coordination

3. Example Skill Usage:

   "Help me set up a decentralized oracle network for ETH/USD price feeds"
   "Coordinate a cross-chain swap from Ethereum to Polygon"
   "Create an intent for yield farming optimization"
   "Monitor keeper network health and performance"

Benefits for DeFi

• Decentralization: Replace centralized infrastructure with peer-to-peer networks

• Censorship Resistance: Operate without single points of failure

• Cost Efficiency: Reduce reliance on expensive centralized APIs

• Privacy: Enable private coordination channels for sensitive operations

• Scalability: Leverage libp2p's efficient P2P communication protocols

• Interoperability: Connect disparate DeFi protocols and blockchains

Real-World DeFi Applications

1. Decentralized Oracles: Chainlink-style oracle networks without centralized nodes

2. Cross-Chain Bridges: Secure message passing between L1/L2 networks

3. Intent-Based DEXs: Privacy-preserving intent propagation (like CoW Swap)

4. Keeper DAOs: Decentralized automation networks for liquidations and rebalancing

5. DeFi Data Availability: Off-chain data sharing for rollups and Layer 2 solutions

6. MEV Mitigation: Private solver networks and coordination channels

Available Tools

Node Management

• create_libp2p_node - Initialize a new libp2p node

• start_libp2p_node - Start the libp2p node

• stop_libp2p_node - Stop the libp2p node

• get_node_status - Get current node status

Peer Management

• discover_peers - Discover peers on the network

• connect_to_peer - Connect to a specific peer

• disconnect_from_peer - Disconnect from a peer

• list_connections - List active connections

• get_peer_info - Get detailed peer information

• ping_peer - Ping a peer to test connectivity

Messaging

• send_group_message - Send message to a topic

• send_direct_message - Send private message to a peer

• subscribe_to_topic - Subscribe to a pubsub topic

• unsubscribe_from_topic - Unsubscribe from a topic

• get_message_history - Retrieve message history

• get_topic_subscribers - Get topic subscriber list

File Sharing

• share_file - Share a file with the network

• request_file - Request a file from a peer

• list_shared_files - List available shared files

• announce_file - Announce file availability

Monitoring

• get_network_stats - Get network statistics

• get_protocol_handlers - List protocol handlers

• enable_debug_logging - Configure debug logging

• get_peer_store_info - Get peer store information

DeFi Tools

Oracle Networks

• submit_oracle_data - Submit price/data feeds to oracle networks

• query_oracle_data - Query aggregated oracle data for assets

Cross-Chain Communication

• relay_cross_chain_message - Relay messages between blockchain networks

• get_bridge_status - Monitor cross-chain bridge status

Intent-Based DeFi

• submit_intent - Submit DeFi intents for execution

• discover_intent_solvers - Find available intent solvers

Decentralized Data Availability

• publish_da_data - Publish data to DA networks

• retrieve_da_data - Retrieve data from DA networks

Keeper Networks

• register_keeper - Register automated keepers

• coordinate_keeper_action - Coordinate keeper operations

Available Resources

• connections://active - Current active connections

• peers://discovered - Recently discovered peers

• network://stats - Network statistics

• node://info - Node information and status

• files://shared - Shared files catalog

• messages://topic/{topicName} - Messages for specific topic

• messages://peer/{peerId} - Direct messages with specific peer

DeFi Resources

• defi://oracle-data - Oracle data feeds and aggregation

• defi://cross-chain-status - Cross-chain bridge status

• defi://intents-active - Active DeFi intents

• defi://keepers-network - Keeper network status

• defi://da-data - Decentralized data availability

Configuration

The server supports various configuration options:

interface NodeConfig {
  transports?: string[]           // ['webrtc', 'websockets', 'webtransport']
  enableRelay?: boolean          // Enable circuit relay (default: true)
  bootstrapPeers?: string[]      // Custom bootstrap peer multiaddrs
  listenAddresses?: string[]     // Custom listen addresses
}

Protocol Support

• WebRTC: Browser-to-browser connections

• WebSockets: Traditional WebSocket connections

• WebTransport: Modern QUIC-based transport

• Circuit Relay: NAT traversal and hole punching

• Gossipsub: Publish-subscribe messaging

• Direct Messages: Peer-to-peer messaging protocol

• File Exchange: Custom file sharing protocol

Error Handling

The server provides comprehensive error handling with descriptive messages:

• Connection failures and timeouts

• Invalid peer IDs or multiaddrs

• Network protocol errors

• File transfer interruptions

• Message delivery failures

Development

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

# Run tests
npm run test

# Lint code
npm run lint

# Format code
npm run format

Architecture

The MCP server is built with a modular architecture:

• State Manager: Centralized state management

• Tool Handlers: Organized by functionality (node, peer, messaging, etc.)

• Resource Providers: Dynamic resource access

• Protocol Integration: Direct integration with libp2p protocols

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests for new functionality

5. Submit a pull request

Related Projects

• libp2p - Modular peer-to-peer networking stack

• universal-connectivity - Universal connectivity examples

• Model Context Protocol - MCP specification