@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

Related MCP server: @1ly/mcp-server

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.

• Source: github.com/portalsprotocol/mcp-server

• License: MIT

• Client SDK: @portalsprotocol/client

Links

• Website: https://portalsprotocol.com

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

• Documentation: https://portalsprotocol.com/docs

• Issues: https://github.com/portalsprotocol/mcp-server/issues

License

MIT © Portals Protocol