MCP Server

Use Orsa as a tool provider for AI assistants via the Model Context Protocol (MCP) (opens in a new tab). Works with Claude Desktop, Cursor, and any MCP-compatible client.

What is MCP?

MCP is an open protocol that lets AI assistants use external tools. With the Orsa MCP server, Claude and other assistants can:

Scrape websites for real-time content
Look up brand data (logos, colors, industry)
Extract products and pricing
Query websites with natural language
Crawl entire sites

Installation

npm

npm install -g @orsa-dev/mcp-server

npx (no install)

npx @orsa-dev/mcp-server

Claude Desktop Setup

Add the Orsa MCP server to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop after saving.

Cursor Setup

Add to your Cursor MCP settings (.cursor/mcp.json in your project root):

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

Available Tools

Once configured, the following tools are available to your AI assistant:

Tool	Description	Credits
`orsa_brand_retrieve`	Get brand data for a domain	5
`orsa_brand_screenshot`	Take a website screenshot	5
`orsa_brand_styleguide`	Extract visual design system	10
`orsa_web_scrape_html`	Scrape raw HTML	1
`orsa_web_scrape_markdown`	Scrape as clean markdown	1
`orsa_web_scrape_images`	Extract all images	1
`orsa_web_scrape_sitemap`	Parse sitemap URLs	1
`orsa_ai_query`	Natural language data extraction	10
`orsa_ai_products`	Extract all products from a domain	10
`orsa_ai_product`	Extract single product from URL	10

Usage Examples

Once the MCP server is running, just ask Claude naturally:

"What are the brand colors for linear.app?"
"Scrape the pricing page of stripe.com and summarize the plans."
"Extract all products from shopify.com with their prices."
"Take a screenshot of github.com in dark mode."
"What fonts does vercel.com use?"

Claude will automatically call the appropriate Orsa tool.

Environment Variables

Variable	Required	Description
`ORSA_API_KEY`	Yes	Your Orsa API key
`ORSA_BASE_URL`	No	Custom API base URL (default: `https://api.orsa.dev`)

Troubleshooting

Tools not appearing in Claude

Verify the config file path is correct for your OS
Ensure ORSA_API_KEY is set (not an empty string)
Restart Claude Desktop completely (quit + relaunch)
Check Claude Desktop logs for MCP connection errors

"API key invalid" errors

Get your key at orsa.dev/dashboard/api-keys (opens in a new tab)
Make sure the key is for the correct environment (production vs development)

Timeout errors

Some tools (AI query, styleguide extraction) can take 30-90 seconds. The MCP server handles timeouts automatically, but if you see frequent timeouts, the target website may be slow or blocking requests.

Ruby Zapier