Oriyn MCP

Oriyn MCP is the primary way to connect AI agents to Oriyn. It gives MCP-capable clients direct, authenticated tools for product context, personas, patterns, and research workflows.

Use the skill after MCP if you want the agent to understand when to reach for Oriyn and how to summarize results. The MCP server is the capability layer; the skill is the instruction layer.

Quick Install

npx -y install-mcp@latest https://mcp.oriyn.ai --client claude --oauth yes

Replace claude with your MCP client when supported by the installer, such as cursor, windsurf, or vscode.

Manual Configuration

Add Oriyn as a remote MCP server in your client:

{
  "mcpServers": {
    "oriyn": {
      "url": "https://mcp.oriyn.ai"
    }
  }
}

This connects the full agent surface. Read tools expose product intelligence, personas, hypotheses, bottlenecks, research modes, and research runs. Write tools queue durable Oriyn workflows and should require user approval in the client.

Research-Only Endpoint

Use the research endpoint when a client only needs read-only retrieval:

{
  "mcpServers": {
    "oriyn-research": {
      "url": "https://mcp.oriyn.ai/research"
    }
  }
}

The research endpoint exposes search and fetch, which is the right surface for private product knowledge retrieval and deep-research-style workflows.

Available Tools

Pair With The Skill

Install the Oriyn skill so coding agents know when to use MCP or the CLI and how to report Oriyn's structured output:

npx skills add oriyn-ai/skills

The skill does not replace MCP. It gives agents operating instructions, caveats, and reporting conventions.