Oxira

An MCP (Model Context Protocol) server for developers to evaluate business ideas. Provides tools for market research, competitor analysis, community discovery, and pricing extraction.

Works with any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Cline, etc.). ChatGPT does not support MCP—it uses a separate plugin system.

Features

• estimate_market_size — Estimate Total Addressable Market (TAM) for an industry with confidence levels and sources
• search_competitors — Find competitors with descriptions, taglines, and features
• find_communities — Discover HackerNews, Reddit, Discord, and forum communities
• extract_pricing — Fetch pricing pages as markdown for LLM analysis

Prerequisites

• Node.js 18+
• Brave Search API key (free tier available)
• Optional: Tavily API key for fallback when Brave is unavailable

Installation

Via npx (recommended)

No installation required. Add Oxira directly to your MCP client config and it will be downloaded automatically on first use.

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "oxira": {
      "command": "npx",
      "args": ["-y", "oxira"],
      "env": {
        "BRAVE_SEARCH_API_KEY": "your_key_here",
        "TAVILY_API_KEY": "optional_fallback_key"
      }
    }
  }
}

macOS + nvm users: Claude Desktop may resolve npx to an older Node version. Use an absolute path to avoid this: "/opt/homebrew/bin/npx" instead of "npx".

Install from source

git clone https://github.com/your-username/oxira.git
cd oxira
npm install
npm run build

Then point your MCP config at the built file:

{
  "mcpServers": {
    "oxira": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/path/to/oxira/dist/index.js"],
      "env": {
        "BRAVE_SEARCH_API_KEY": "your_key_here"
      }
    }
  }
}

Configuration

API keys are passed via env in the MCP config (shown above). To run manually, create a .env file:

BRAVE_SEARCH_API_KEY=your_key_here
TAVILY_API_KEY=optional_fallback_key

See .env.example for the template.

Usage

Run manually

npm start

The server communicates over stdio using JSON-RPC. MCP clients manage the lifecycle.

Development

npm run build      # Compile TypeScript to dist/
npm run dev        # Watch mode
npm test           # Run tests
npm run test:watch # Tests in watch mode
npm run lint       # Run ESLint

Architecture

src/
├── index.ts       # MCP server entry point
├── types.ts       # Zod schemas and TypeScript types
├── tools/         # Tool implementations
├── services/      # API clients (Brave, Tavily, HN Algolia, web fetcher)
└── utils/         # Rate limiter, retry logic

License

MIT — see LICENSE.