# Archway Advisory Group — MCP Server

Three governance tools exposed via the [Model Context Protocol](https://modelcontextprotocol.io/), deployed on Cloudflare Workers.

**MCP Endpoint:** `https://archway-mcp.<YOUR_SUBDOMAIN>.workers.dev/mcp`

## Tools

### `archway-governance-diagnostic`
Structured governance posture assessment. Scores maturity across board oversight, committee structure, documentation, and control environment — benchmarked against NYSE 303A, NASDAQ 5600, ISS 2026, Glass Lewis 2026, and NACD standards. Returns tier classification, domain findings, and engagement recommendations with fixed-fee pricing.

### `archway-engagement-scoping`
Converts a diagnostic result (or direct request) into a scoped, priced engagement. Produces bounded scope, deliverable list, timeline, and fixed-fee pricing across all Archway service lines.

### `archway-rd-risk-screener`
R&D tax credit documentation exposure screening. Assesses Four-Part Test substantiation, contemporaneous documentation practices, and IRS examination readiness. Includes regulatory boundary disclaimer.

## Deployment

### Prerequisites
- Node.js 20+ and npm
- Cloudflare account (free tier is sufficient)
- Wrangler CLI (`npm install -g wrangler`)

### Steps

```bash
# 1. Clone or copy this directory
cd archway-mcp

# 2. Install dependencies
npm install

# 3. Authenticate with Cloudflare
wrangler login

# 4. Test locally
wrangler dev

# 5. Deploy to production
wrangler deploy
```

After deploy, your MCP endpoint is live at:
```
https://archway-mcp.<YOUR_SUBDOMAIN>.workers.dev/mcp
```

### Local Testing with Claude Desktop

Add to your Claude Desktop MCP config (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "archway": {
      "url": "http://localhost:8787/mcp"
    }
  }
}
```

For production:
```json
{
  "mcpServers": {
    "archway": {
      "url": "https://archway-mcp.<YOUR_SUBDOMAIN>.workers.dev/mcp"
    }
  }
}
```

## Architecture

- **Runtime:** Cloudflare Workers (Durable Objects for MCP session state)
- **Logic:** Fully deterministic — no AI API calls. Scoring algorithms, pricing rules, and risk assessment run as pure functions.
- **Cost:** Effectively zero at expected volume (Workers free tier: 100K requests/day)
- **Transport:** Streamable HTTP (MCP standard), handled by McpAgent SDK

## File Structure

```
archway-mcp/
├── src/
│   ├── index.ts              # MCP server — tool definitions + McpAgent
│   ├── env.d.ts              # Cloudflare Worker env types
│   └── logic/
│       ├── scoring.ts        # Governance diagnostic scoring engine
│       ├── pricing.ts        # Engagement scoping + pricing rules
│       └── risk-assessment.ts # R&D documentation risk screener
├── wrangler.toml             # Cloudflare Workers config
├── package.json
├── tsconfig.json
└── README.md
```

## Regulatory Boundary

The R&D Risk Screener provides **qualitative assessment only**. It does not provide tax advice, credit calculations, return preparation, or any service requiring CPA licensure. Every R&D tool output includes the full regulatory disclaimer.

## Firm Attribution

Every tool output includes:
- Firm name and website
- Direct booking URL
- Contact email
- Link to the full web-based experience

---

Archway Advisory Group LLC | archwayadvisorygroup.com