Orsa MCP Server

Model Context Protocol server for the Orsa.dev API. Gives LLMs direct access to brand data, web scraping, and AI extraction tools. Human-readable docs: docs.orsa.dev.

Available Tools

| Tool | Description | |------|-------------| | scrape_html | Scrape a URL → raw HTML | | scrape_markdown | Scrape a URL → clean markdown | | scrape_images | Extract all images from a page | | scrape_sitemap | Parse a domain's sitemap.xml | | crawl_website | Start a multi-page crawl job | | get_brand | Full brand data (logos, colors, socials, metadata) | | get_brand_by_name | Brand lookup by company name | | get_brand_by_email | Brand lookup by email address | | get_brand_screenshot | Screenshot a website | | get_brand_styleguide | Extract visual design system | | get_brand_fonts | Extract font information | | get_naics | NAICS industry classification | | identify_transaction | Identify brand from transaction descriptor | | ai_query | AI-powered custom data extraction | | extract_products | Extract all products from a domain | | extract_product | Extract product details from a URL |

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "orsa": {
      "command": "npx",
      "args": ["-y", "@orsa.dev/mcp-server"],
      "env": {
        "ORSA_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "orsa": {
      "command": "npx",
      "args": ["-y", "@orsa.dev/mcp-server"],
      "env": {
        "ORSA_API_KEY": "your-api-key"
      }
    }
  }
}

From Source

# Clone and build
cd packages/mcp-server
pnpm install
pnpm build

# Run
ORSA_API_KEY=your-key node dist/index.js

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ORSA_API_KEY | Yes | Your Orsa API key from orsa.dev/dashboard | | ORSA_BASE_URL | No | API origin (default https://api.orsa.dev) |

Examples

Once connected, you can ask your LLM things like:

• "Get me the brand colors and logos for stripe.com"
• "Scrape the pricing page at https://linear.app/pricing and extract the plan details"
• "What NAICS codes does notion.so fall under?"
• "Extract all products from shopify.com/examples"
• "Take a screenshot of apple.com in dark mode"
• "What brand is the transaction 'AMZN MKTP US' from?"

License

MIT