# qubitsok MCP Server

Production MCP (Model Context Protocol) server for [qubitsok.com](https://qubitsok.com) — the quantum computing career and research platform.

## Endpoint

```
https://qubitsok.com/mcp
```

Transport: **Streamable HTTP** (MCP spec 2025-11-25)
Authentication: **None** — all tools are read-only and publicly accessible.

## Tools (7)

| Tool | Description |
|------|-------------|
| `searchJobs` | AI-powered natural language quantum job search (500+ listings) |
| `getJobDetails` | Full details for a specific job by ID |
| `searchPapers` | Search arXiv quantum papers by topic, author, affiliation, date |
| `getLatestPapers` | Today's quantum computing papers from arXiv |
| `getPaperDetails` | Full paper analysis with abstract, methodology, gist |
| `searchCollaborators` | Find quantum researchers by expertise, affiliation, topic (1000+ profiles) |
| `getMarketOverview` | Job market and research landscape statistics |

## Prompts (4)

| Prompt | Description |
|--------|-------------|
| `quantum-job-search` | Guided quantum job search with formatted results |
| `daily-paper-briefing` | Today's quantum paper highlights briefing |
| `find-collaborator` | Discover researchers to collaborate with |
| `quantum-market-pulse` | Market and research landscape overview |

## Connect

### Claude Desktop / Claude.ai

Add as remote MCP server in Settings > MCP:
```
https://qubitsok.com/mcp
```

### Claude Code

```bash
claude mcp add --transport streamable-http qubitsok https://qubitsok.com/mcp
```

### ChatGPT (Developer Mode)

Settings > Apps & Connectors > Advanced > Developer Mode > Add Connector:
- URL: `https://qubitsok.com/mcp`
- Name: qubitsok — Quantum Computing Jobs & Research

### Gemini CLI

```bash
gemini extensions install github:navaro1/qubitsok-mcp
```

### Cursor / Windsurf / VS Code

Add to your MCP configuration:

```json
{
  "qubitsok": {
    "transport": "streamable-http",
    "url": "https://qubitsok.com/mcp"
  }
}
```

### Grok (xAI API)

```json
{
  "mcp_servers": [
    { "url": "https://qubitsok.com/mcp", "name": "qubitsok" }
  ]
}
```

### Perplexity (Mac App)

Settings > Connectors > Add MCP > `https://qubitsok.com/mcp`

## Discovery

```bash
curl https://qubitsok.com/.well-known/mcp.json
```

## Example Queries

**Jobs**: "Find senior quantum error correction engineer roles in Europe paying over 120k EUR"

**Papers**: "Show me trapped ion papers from Google published this month"

**Researchers**: "Who are the top quantum error correction researchers at MIT?"

**Market**: "How's the quantum computing job market right now?"

## Safety

All 7 tools have `readOnlyHint: true` — no destructive operations. Read-only public data access.

## License

MIT