Metadata-Version: 2.4
Name: sensecritiq-mcp
Version: 0.1.4
Summary: MCP server for SenseCritiq — UX research synthesis agent
Project-URL: Homepage, https://sensecritiq.com
Project-URL: Repository, https://github.com/salvisare/sensecritiq
License: MIT
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# SenseCritiq MCP Server

mcp-name: io.github.salvisare/sensecritiq

SenseCritiq turns raw research into actionable insights - automatically.

Upload an interview recording, transcript, or survey and Claude will transcribe it, extract themes, surface verbatim quotes with speaker attribution, and generate structured findings in minutes. No more manual affinity mapping. No more hours spent tagging transcripts. Your entire research history becomes queryable in plain language.

Built for UX researchers, product teams, and anyone who talks to users.

## What you can do

- **Upload any format** - audio (mp3, m4a, wav, mp4), transcripts (txt, pdf, docx)
- **Get structured synthesis** - themes, key findings, verbatim quotes - each pinned to speaker and timestamp
- **Search across all sessions** - semantic search over your full research history
- **Generate reports** - export as Markdown or PDF with one tool call
- **Query in plain language** - ask questions across months of research, get cited answers

## Setup

1. Sign up and get your API key at [sensecritiq.com](https://sensecritiq.com)
2. Add to your Claude Desktop `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "sensecritiq": {
      "command": "uvx",
      "args": ["sensecritiq-mcp"],
      "env": {
        "SCQ_API_KEY": "scq_live_your_key_here"
      }
    }
  }
}
```

3. Restart Claude Desktop. SenseCritiq tools will appear automatically.

## Tools

### `upload_research_file`
Upload an audio recording, video, or transcript for processing. Returns a `session_id` to track progress.

**Parameters:** `file_path` (required), `session_name` (required), `project_id` (optional), `tags` (optional)

### `get_session_status`
Poll processing status after upload. Values: `queued → processing → ready → failed`.

**Parameters:** `session_id` (required)

### `get_synthesis`
Retrieve themes, key findings, and quote count for a completed session. Every finding cites a verbatim source.

**Parameters:** `session_id` (required)

### `get_quotes`
Get verbatim quotes from a session, optionally filtered by theme. Each quote includes speaker label and timestamp.

**Parameters:** `session_id` (required), `theme_id` (optional)

### `search_research`
Semantic search across your entire research history. Ask questions in plain language and get cited answers.

**Parameters:** `query` (required), `project_id` (optional), `date_from` (optional), `date_to` (optional)

### `list_sessions`
List all research sessions, optionally filtered by project.

**Parameters:** `project_id` (optional), `limit` (default 20), `offset` (default 0)

### `generate_report`
Generate a formatted report for a session. Returns a pre-signed download URL valid for 24 hours.

**Parameters:** `session_id` (required), `format` (markdown | pdf | notion)

## Example usage in Claude

```
Upload session-04.m4a as "Onboarding exit interviews - March"
```

```
What do users say about the invite flow across all sessions?
```

```
Generate a PDF report for session sess_abc123
```

## Supported file formats

| Type | Formats |
|------|---------|
| Audio | mp3, m4a, wav, mp4 |
| Transcript | txt, pdf, docx |

## Plans

| Plan | Sessions/month | Price |
|------|---------------|-------|
| Free | 2 | $0 |
| Starter | 10 | $29/mo |
| Growth | 30 | $79/mo |
| Team | 150 | $199/mo |

All plans include full MCP server access and all 7 tools.

## License

MIT
