mcp-server

portalsprotocol/mcp-server

3.2

If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

MCP server for Portals Protocol enables AI agents to access decentralized tools on Solana, facilitating autonomous tool discovery and usage without human intervention.

@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

  1. First run: Auto-creates wallet at ~/.portals/wallet.json
  2. Fund wallet: Send SOL (gas) + USDC (payments) to displayed address
  3. Whitelist Portals: Add Portal IDs you want to use
  4. 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:

  1. Creates ~/.portals/ directory
  2. Generates new wallet → ~/.portals/wallet.json
  3. Shows wallet address and balances
  4. 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

Transparency

This package includes full TypeScript source code for complete transparency. Review before connecting your AI agent.

Links

License

MIT © Portals Protocol