streamable-httpMITupdated 8d ago
SubcueAI (the real-time AI interview assistant for macOS & Windows) ships a public, unauthenticated, read-only Model Context Protocol server. Any AI agent can query live product data ā pricing, latest desktop version, product overview, FAQ ā instead of scraping HTML.
What can you do with SubcueAI?
SubcueAI Public MCP Server
mcp-name: io.github.Subcue/subcue-mcp
SubcueAI (the real-time AI interview assistant for macOS & Windows) ships a public, unauthenticated, read-only Model Context Protocol server. Any AI agent can query live product data ā pricing, latest desktop version, product overview, FAQ ā instead of scraping HTML.
- Endpoint:
POST https://subcue.ai/mcp - Transport: streamable-http (single JSON response), JSON-RPC 2.0, MCP protocol
2025-06-18 - Auth: none. Writes: none ā the server is strictly read-only.
- Server card:
https://subcue.ai/.well-known/mcp/server-card.json
This repository documents the server and provides ready-to-run client examples. The server itself runs on Cloudflare Workers as part of the SubcueAI website.
Quick start
# List tools
curl -s https://subcue.ai/mcp -X POST -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# Live pricing
curl -s https://subcue.ai/mcp -X POST -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_pricing"}}'
Sample get_pricing output (live data, abridged):
# SubcueAI Pricing
## Starter ā free
- Standard AI model
- Mock interview practice
## Pro ā $20/mo; $16/mo when billed yearly ($192/yr)
...
Tools
| Tool | Arguments | Returns |
|---|---|---|
get_pricing |
ā | Current subscription plans and pricing (Markdown) |
get_latest_version |
platform (optional, e.g. macos-arm64, windows-x64) |
Latest desktop app version, release date, download URL |
Resources
| URI | Content |
|---|---|
subcue://overview |
What SubcueAI is, key features, links (Markdown) |
subcue://faq |
Frequently asked questions (Markdown) |
Use resources/list / resources/read per the MCP spec.
Connect from popular clients
Claude Code
claude mcp add --transport http subcue https://subcue.ai/mcp
Cursor / any client using mcp.json
{
"mcpServers": {
"subcue": { "url": "https://subcue.ai/mcp" }
}
}
claude.ai ā Settings ā Connectors ā Add custom connector ā https://subcue.ai/mcp.
Stdio-only clients ā this repo ships a zero-dependency stdio ā HTTP bridge (bridge/server.mjs, Node 18+):
claude mcp add subcue -- node /path/to/subcue-mcp/bridge/server.mjs
# or containerised:
docker build -t subcue-mcp . && docker run -i subcue-mcp
Examples in this repo
examples/list-tools.shā curl walkthrough of every methodexamples/client.mjsā zero-dependency Node.js clientexamples/client.pyā zero-dependency Python client
Other machine-readable entry points
SubcueAI publishes a full agent-facing surface beyond MCP:
| Endpoint | What it is |
|---|---|
/llms.txt |
Plain-text site & product summary for language models |
/.well-known/api-catalog |
RFC 9727 linkset of public JSON APIs |
/.well-known/agent-skills/index.json |
Agent Skills discovery index |
/.well-known/agent-skills/subcue-public-info/SKILL.md |
Agent skill: how to fetch SubcueAI public data |
Accept: text/markdown |
Any public marketing/legal page returns Markdown instead of HTML |
Notes for agent developers
- Responses are deterministic JSON-RPC; notifications (
notifications/*) are accepted and return202with no body. - Data is live (pricing and versions come from the same source of truth as the website) ā prefer these endpoints over scraping rendered HTML.
- Rate limiting applies at the edge; be a good citizen.
- Send a descriptive
User-Agentā default library UAs (e.g.Python-urllib/3.x) are rejected by edge bot protection with a403.
License
Documentation and examples: MIT Ā© 2026 Subcue AI LLC.
Install
Add SubcueAI to your client. Pick the one you use.
claude mcp add --transport http subcueai https://subcue.ai/mcpcodex mcp add subcueai --url https://subcue.ai/mcp{
"mcpServers": {
"subcueai": {
"url": "https://subcue.ai/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"subcueai": {
"type": "http",
"url": "https://subcue.ai/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"subcueai": {
"url": "https://subcue.ai/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"subcueai": {
"serverUrl": "https://subcue.ai/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
2 tools
SubcueAI exposes 2 tools to a connected agent.
- get_pricing
- ā
- get_latest_version
- `platform` (optional, e.g. `macos-arm64`, `windows-x64`)
Score
79 / 100
Good
- Documentation25/25
- Maintenance19/25
- Trust16/20
- Capability7/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 0 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 2 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint ā no local install
Version history
| Versions | Published |
|---|---|
| 1.0.0Latest | Aug 31, 2026 |