noya-agent-mcp

An MCP (Model Context Protocol) server that connects AI agents to the Noya AI platform — enabling crypto trading, prediction markets (Polymarket, Rain), token analysis, DCA strategies, and cross-chain operations through a standardized tool interface.

Prerequisites

1. Create an account at agent.noya.ai
2. Generate an API key from Settings > API Keys
3. Store the key securely — it is shown only once

Installation

Using npx (recommended)

No installation needed. Configure your MCP client to run:

{
  "mcpServers": {
    "noya-agent": {
      "command": "npx",
      "args": ["-y", "noya-agent-mcp"],
      "env": {
        "NOYA_API_KEY": "noya_your_key_here"
      }
    }
  }
}

Global install

npm install -g noya-agent-mcp

Then run:

NOYA_API_KEY=noya_your_key_here noya-agent-mcp

Configuration

x402 Payment Support

This server supports the x402 payment protocol. When API endpoints are placed behind a payment gateway, the server automatically handles HTTP 402 Payment Required responses by signing and submitting EVM payments.

To enable, set the EVM_PRIVATE_KEY environment variable to your wallet's private key. The server registers against all EVM chains (eip155:*), so it can pay on any supported network (Base, Ethereum, Arbitrum, etc.) depending on what the server-side endpoint requires.

If EVM_PRIVATE_KEY is not set, the server operates normally without payment capabilities — no other changes needed.

{
  "mcpServers": {
    "noya-agent": {
      "command": "npx",
      "args": ["-y", "noya-agent-mcp"],
      "env": {
        "NOYA_API_KEY": "noya_your_key_here",
        "EVM_PRIVATE_KEY": "0xyour_private_key_here"
      }
    }
  }
}

Available Tools

noya_send_message

Send a message to the full Noya multi-agent system and receive a complete response. Supports threaded conversations with context persistence.

Parameters:

• message (string, required) — The message to send
• threadId (string, required) — Conversation thread ID

Example: "What is the current price of ETH?" with threadId "eth-analysis"

noya_list_threads

List all conversation threads for the authenticated user.

Parameters: None

noya_get_thread_messages

Retrieve all messages from a specific conversation thread.

Parameters:

• threadId (string, required) — Thread ID to retrieve

noya_delete_thread

Permanently delete a conversation thread and its messages.

Parameters:

• threadId (string, required) — Thread ID to delete

noya_chat_completion

Send a message via the OpenAI-compatible chat completion endpoint. Maintains session history. Does not use the full agent graph — for agent features, use noya_send_message.

Parameters:

• message (string, required) — The user message
• sessionId (string, required) — Session ID for history

noya_get_session_history

Retrieve message history for a chat session.

Parameters:

• sessionId (string, required) — Session ID

noya_clear_session

Clear all message history for a chat session.

Parameters:

• sessionId (string, required) — Session ID to clear

noya_get_agent_summary

Get a summary of all available Noya agent types, their specialties, and tools.

Parameters: None

Data Endpoint Tools

In addition to the conversational agent tools above, this server exposes Noya's public data endpoints as first-class MCP tools under the noya_data_* prefix. These endpoints require no authentication and provide direct structured-data access without routing through the agent graph — ideal for deterministic lookups (prices, TVL, funding rates, wallet balances, news, sentiment, prediction markets, etc.).

All data tools return raw JSON from the upstream provider, pretty-printed.

alternative.me

• noya_data_alternative_fear_greed — Crypto Fear & Greed Index

Bitquery

• noya_data_bitquery_query_onchain — Execute a raw GraphQL query against on-chain data
• noya_data_bitquery_dex_trades — Recent DEX trades for a token

CoinGecko

• noya_data_coingecko_price — Batch spot prices
• noya_data_coingecko_ohlcv — Historical OHLCV candles
• noya_data_coingecko_token_info — Token metadata & contract addresses
• noya_data_coingecko_trending — Trending tokens
• noya_data_coingecko_search — Search tokens by name/symbol
• noya_data_coingecko_price_history — Timeseries prices
• noya_data_coingecko_price_at_date — Price snapshot at a date

CoinGlass

• noya_data_coinglass_funding_rates — Perp funding rates
• noya_data_coinglass_open_interest — Open interest by exchange
• noya_data_coinglass_liquidations — Aggregated liquidations per coin
• noya_data_coinglass_long_short_ratio — Long/short taker ratio
• noya_data_coinglass_supported_coins — Supported coin symbols
• noya_data_coinglass_supported_exchanges — Supported exchanges
• noya_data_coinglass_exchange_pairs — Futures trading pairs
• noya_data_coinglass_liquidations_by_exchange — Liquidations per exchange

CryptoVision

• noya_data_cryptovision_news — Curated crypto news with credibility scores

DeFiLlama

• noya_data_defillama_tvl — Protocol or chain TVL
• noya_data_defillama_yields — Yield pools (APY/APR)
• noya_data_defillama_protocol_fees — Protocol fees and revenue
• noya_data_defillama_dex_volumes — DEX trading volumes
• noya_data_defillama_stablecoins — Stablecoin supply and distribution
• noya_data_defillama_bridges — Bridge volume and flows
• noya_data_defillama_bridges_list — All cross-chain bridges

Moralis

• noya_data_moralis_wallet — Wallet balances and net worth
• noya_data_moralis_transfers — ERC20 transfer history
• noya_data_moralis_defi_positions — Active DeFi positions
• noya_data_moralis_nft_holdings — NFT holdings

Noya Tokens (AI-scored token catalog)

• noya_data_tokens_search — Text + structured filter search
• noya_data_tokens_similar — Similar tokens
• noya_data_tokens_recommendations — Recommendations by risk tolerance
• noya_data_tokens_top_score — Top AI-scored tokens
• noya_data_tokens_health — Service health
• noya_data_tokens_versions — Available analysis versions
• noya_data_tokens_by_version — Tokens for a specific version
• noya_data_tokens_detail — Full analysis detail for a token

Noya Polymarket (prediction market intelligence)

• noya_data_polymarket_search — Semantic search
• noya_data_polymarket_similar — Similar markets
• noya_data_polymarket_recommendations — Personalized recommendations
• noya_data_polymarket_top_ev — Top markets by expected value
• noya_data_polymarket_filter — Hybrid text + filter search
• noya_data_polymarket_events — Event list
• noya_data_polymarket_by_event — Markets for an event slug
• noya_data_polymarket_tags — Available tags
• noya_data_polymarket_health — Service health

Santiment

• noya_data_santiment_sentiment — Social sentiment time-series for a token
• noya_data_santiment_social_trending — Tokens trending on social media

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
NOYA_API_KEY=noya_xxx node dist/index.js

License

MIT