Skip to content
Oriyn
Agents

Oriyn MCP

Connect AI agents directly to Oriyn through remote 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 the client you use. Common values include codex, cursor, windsurf, vscode, and claude-code.

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 through one endpoint. 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.

Available Tools

CategoryTools
Read toolsProducts, product context, personas, bottlenecks, hypotheses, research modes, research runs, research events
Write toolsStart or cancel research runs, refresh personas, refresh hypotheses, refresh product context

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.

On this page