Scira AI MCP Server

A Model Context Protocol (MCP) server that provides AI-powered search capabilities through the Scira AI platform. This server offers three specialized search tools for comprehensive information retrieval.

Features

This MCP server provides the following tools:

🔍 Web Search (search)

• Description: Search the web for comprehensive information
• Use Case: Get real-time web search results with AI-powered analysis
• Returns: Structured search results with sources

👥 People Search (people)

• Description: Search for detailed people profiles and information
• Use Case: Find professional profiles, social media, and biographical data
• Returns: Name, social profiles (X, LinkedIn, GitHub), website, and bio

🐦 X Platform Search (xsearch)

• Description: Search for posts and content on X (formerly Twitter)
• Use Case: Find relevant tweets, discussions, and social media content
• Parameters: Query string and optional username filter
• Returns: X posts and content with sources

Prerequisites

• Node.js 20.0.0 or higher
• A valid Scira AI API key

How to use the MCP server

1. Put the MCP server url: https://mcp.scira.ai/mcp
2. Get the API Key from the Scira AI Platform(https://api.scira.ai)
3. Put the API Key in the MCP server config with the key x-api-key:

{
  "x-api-key": "your-api-key"
}

4. You can use the MCP server in your Scira AI MCP client(https://mcpchat.scira.ai)

Setup

1. Clone this repository
2. Install dependencies:

   pnpm install
   

3. Set up your Scira AI API key (the server expects it via x-api-key header or Authorization: Bearer <token>)

Development

Run the development server:

pnpm dev

This starts the MCP server in development mode with hot reloading.

Building for Production

Build the project:

pnpm build

Running in Production

Start the HTTP server:

pnpm start

The server will run on port 3002 by default (configurable in xmcp.config.ts).

Configuration

The server is configured via xmcp.config.ts with the following defaults:

• Port: 3002
• CORS: Enabled for all origins
• Body Size Limit: 10MB

API Authentication

All tools require authentication through the Scira AI API. The server accepts API keys via:

• x-api-key header
• Authorization: Bearer <token> header

Architecture

This project uses the xmcp framework with automatic tool discovery. Each tool is defined in the src/tools/ directory with:

• Schema: Zod-based parameter validation
• Metadata: Tool description and annotations
• Implementation: Async function that calls Scira AI APIs

Learn More

• xmcp Documentation
• Scira AI Platform