MCP 服务器

@portalsprotocol/mcp-server

Connects AI agents to decentralized, community-built APIs on Solana, enabling autonomous discovery, payment, and execution of tools without subscriptions or API keys.

README

@portalsprotocol/mcp-server

MCP server for Portals Protocol - Give your AI agent access to decentralized tools

Connect your AI agent (Claude, Cursor, etc.) to community-built APIs on Solana. Agents discover Portals on-chain, pay in USDC per use, and access tools autonomously—no API keys, no subscriptions, no human intervention.

Live on Mainnet • Browse Portals • Docs

Quick Start

Add to your MCP config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "portals": {
      "command": "npx",
      "args": ["-y", "@portalsprotocol/mcp-server"],
      "env": {
        "PORTALS_WHITELIST": "PORTAL_ID_1,PORTAL_ID_2"
      }
    }
  }
}

Browse available Portals: https://portalsprotocol.com/browse

What Your Agent Can Do

Example Portals (built by the community):

Social media APIs (search, post, analyze)
Image generation (various models and styles)
Data analytics (charts, insights, reports)
Web scraping (extract, parse, structure)

Each Portal is a product with multiple related tools. Agents pay per use in USDC. No subscriptions. No accounts.

How It Works

First run: Auto-creates wallet at ~/.portals/wallet.json
Fund wallet: Send SOL (gas) + USDC (payments) to displayed address
Whitelist Portals: Add Portal IDs you want to use
Agent takes over: Discovers tools, pays autonomously, executes

Zero human interaction after setup.

Configuration

Required

PORTALS_WHITELIST - Comma-separated Portal IDs to enable:

"PORTALS_WHITELIST": "ABC123...,DEF456..."

Find Portal IDs: https://portalsprotocol.com/browse

Optional

PORTALS_NETWORK - Chain to use (default: mainnet-beta)

"PORTALS_NETWORK": "mainnet-beta"

PORTALS_RPC - Custom RPC endpoint (default: public Solana RPC)

"PORTALS_RPC": "https://your-rpc.example.com"

First Run

On first execution, the server:

Creates ~/.portals/ directory
Generates new wallet → ~/.portals/wallet.json
Shows wallet address and balances
Displays funding instructions if needed

Example output:

New wallet created: 7xK9...Abc
Wallet saved to: /Users/you/.portals/wallet.json

💰 Wallet Balance:
  SOL: 0
  USDC: 0

⚠️  WARNING: No SOL for gas fees!
Send SOL to: 7xK9...Abc

⚠️  WARNING: No USDC for payments!
Send USDC to: 7xK9...Abc
Portal calls will fail until funded.

Features

Auto-wallet management - Creates and loads wallet automatically
Multi-tool support - Each Portal can expose multiple tools
Payment verification - Checks on-chain registry before agent pays
Error-driven UX - Clear balance warnings and funding instructions
Schema caching - Fetches OpenAPI schemas from Portals
Input validation - Validates parameters against Portal schemas

Security

Whitelist-only - Agent can only use Portals you explicitly enable
Payment verification - Checks payment addresses on-chain before sending USDC
Local wallet - Private key stored locally at ~/.portals/wallet.json (mode 0600)
Open source - Full TypeScript source included for audit