The Talk Guide MCP
Provides read-only access to the Bicycle Guide registry, including published guides, homes, taxonomy, and capability spine. It allows agents to query the guide index, book library, and disagreements without requiring authentication.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://thetalk.guide/mcpWhat its tools do
10 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to thetalk.guide ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Access the Bicycle Guide registry
- Query published guides and taxonomy
- Retrieve capability spine data
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- bicycle-guide-registry 1.0.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 10 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Tools
10 advertised
list_guides — List the guide registry
List the bicycle.guide registry — every guide's home, status, access, standard, syndication and grounding, plus the distribution roll-up (including guides homed to a property with no rendering surface).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"home": {
"type": "string",
"description": "Filter by owning property, e.g. jobframe, peopleanalyst, penwright."
},
"limit": {
"type": "number",
"description": "Cap the rows returned. Default 100, max 500."
},
"access": {
"type": "string",
"description": "Filter by access: free | gated."
},
"domain": {
"type": "string",
"description": "Filter by life-domain — the layer ABOVE the subject shelf: work | life | play. Derived from the guide's category via content/registry/shelves.json. `rollup.by_domain` lists them."
},
"fields": {
"enum": [
"compact",
"full"
],
"type": "string",
"description": "Row shape. \"compact\" returns only slug/title/home/status/access/price_cents/has_artifact/category/domain/personas/canonical_url — no rollup, no registry_meta. \"full\" returns the entire decorated registry row plus the rollup and registry_meta, as before. Default over this server: \"compact\"."
},
"series": {
"type": "string",
"description": "Filter by guide series — the operational grouping of guides made to be used together, e.g. competencies, penwright-writing, startup-journey, ladder:hr-business-partner."
},
"status": {
"type": "string",
"description": "Filter by status: on | draft."
},
"persona": {
"type": "string",
"description": "Filter by the audience a guide serves, e.g. people-analytics-professional, aspiring-author, executive-performance-leader. A guide can serve several; this matches any of them."
},
"category": {
"type": "string",
"description": "Filter by subject shelf — the reader-facing topic axis, e.g. field, skills, analytics, writing, comp. Matches the primary category OR a cross-shelf tag."
},
"standard": {
"type": "string",
"description": "Filter by standard: bicycle | life-stage | problem-opportunity."
},
"guide_type": {
"type": "string",
"description": "Filter by guide CLASS: career (level-based job guides, their own program) | capability | book_profile. Combine with series=ladder:<role> to get one role's whole ladder."
},
"has_artifact": {
"type": "boolean",
"description": "Only guides that do (true) / do not (false) have a new-design artifact."
},
"home_unrouted": {
"type": "boolean",
"description": "Only guides whose home has NO rendering surface at all (the distribution gap)."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_version",
"fields",
"count",
"total_matching",
"limit",
"filters",
"guides"
],
"properties": {
"count": {
"type": "number"
},
"limit": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"fields": {
"enum": [
"compact",
"full"
],
"type": "string"
},
"guides": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"slug",
"title",
"home",
"status",
"access",
"price_cents",
"has_artifact",
"category",
"domain",
"personas",
"canonical_url"
],
"properties": {
"home": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"access": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"personas": {
"type": "array",
"items": {
"type": "string"
}
},
"price_cents": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"has_artifact": {
"type": "boolean"
},
"canonical_url": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
]
}
},
"rollup": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"api_version": {
"type": "string"
},
"registry_meta": {},
"total_matching": {
"type": "number"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_guide — Get one guide's registry row
Get one guide's registry row by slug, with its artifact + routing-surface status.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "The guide slug, e.g. start-a-company."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_version",
"guide"
],
"properties": {
"guide": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"api_version": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_taxonomy — Get the guide program's vocabulary
Get the bicycle.guide vocabulary — domains, shelves (with live guide counts), series, personas, guide_types, and the classification conventions (pillar/spoke, discriminant home, bicycle-guide-serves-all) as machine-readable data rather than prose.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_version",
"registry_meta",
"counts_basis",
"domains",
"shelves",
"series",
"personas",
"guide_types",
"conventions",
"unclassified"
],
"properties": {
"series": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"domains": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"shelves": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"personas": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"api_version": {
"type": "string"
},
"conventions": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"guide_types": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"counts_basis": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"unclassified": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"registry_meta": {}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_capabilities — Traverse the capability spine (books · guides · KSAO elements · jobs)
Traverse the capability spine joining books, guides (capability packages), KSAO-grade elements and jobs. Use min_guides=2 for the cross-cutting capabilities that span many guides, role=<role> for what a job requires, capability_detail=<slug> for one package with its elements and books hydrated. ksao_type/canon_component_id are null by design where unresolved — treat null as 'not yet joined', never as 'no link'.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"description": "Substring match on the element label."
},
"role": {
"type": "string",
"description": "Elements required by this job role, e.g. compensation-analyst."
},
"limit": {
"type": "number",
"description": "Cap the rows returned (default 200). `total` always reports the true count."
},
"has_job": {
"type": "boolean",
"description": "Only elements that some job requires (via a career guide)."
},
"ksao_type": {
"type": "string",
"description": "knowledge | skill | ability | other — from a panel validated at 95.1% on gold O*NET labels. 'other' is UNVALIDATED (no gold labels existed for it)."
},
"capability": {
"type": "string",
"description": "Elements taught by this capability (guide slug)."
},
"min_guides": {
"type": "number",
"description": "Only elements taught by >= N capabilities. 2 gives the cross-cutting spine."
},
"conflicting": {
"type": "boolean",
"description": "Only elements where 2+ non-career guides define the same label differently — these need a ruling."
},
"construct_class": {
"type": "string",
"description": "person-attribute (knowledge/skill/ability — what a JOB requires and a learner develops) | condition-or-outcome (what a capability PRODUCES, e.g. 'Retention & Workforce Stability'). Only ~30% of elements are person attributes — filter to these for 'what does this role need'."
},
"capability_detail": {
"type": "string",
"description": "Return ONE capability with its elements and books hydrated, instead of querying elements."
},
"has_canon_identity": {
"type": "boolean",
"description": "true = only elements resolved to a JobFrame canon component (an IDENTITY, panel-adjudicated). false = only unresolved."
},
"canon_promotion_candidate": {
"type": "boolean",
"description": "true = only elements the JobFrame canon has NO component for. This is a real answer, not a failed lookup — these are the constructs to PROMOTE into the canon."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_version",
"spine_meta"
],
"properties": {
"total": {
"type": "number"
},
"elements": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"returned": {
"type": "number"
},
"capability": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"spine_meta": {},
"api_version": {
"type": "string"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}search_guides — Search guides, or refuse with the nearest owned
Search published guides by topic. Returns matches, or a structured refusal with the nearest owned guides and the missing topic. No model call. Filter by persona or category.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Topic or question in plain language. No model call — matched against registry taxonomy and the capability spine."
},
"limit": {
"type": "number",
"description": "Cap hits returned. Default 10, max 20."
},
"persona": {
"type": "string",
"description": "Audience filter. A miss that fails this rule is a structured refusal."
},
"category": {
"type": "string",
"description": "Subject shelf filter. A miss that fails this rule is a structured refusal."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_version",
"covered",
"query",
"missing_topic",
"filters",
"guides",
"nearest",
"suggest"
],
"properties": {
"query": {
"type": "string"
},
"guides": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"home",
"category",
"personas",
"canonical_url",
"why"
],
"properties": {
"why": {
"type": "string"
},
"home": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"personas": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string"
}
},
"additionalProperties": false
}
},
"covered": {
"type": "boolean"
},
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"nearest": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"home",
"category",
"personas",
"canonical_url",
"why"
],
"properties": {
"why": {
"type": "string"
},
"home": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"personas": {
"type": "array",
"items": {
"type": "string"
}
},
"canonical_url": {
"type": "string"
}
},
"additionalProperties": false
}
},
"suggest": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"authors",
"topic"
],
"properties": {
"title": {
"type": "string"
},
"topic": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"authors": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"api_version": {
"type": "string"
},
"missing_topic": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_disagreements — List cross-book disagreements
Where does the field disagree? Returns cross-book tension names and the books on each pole (title, author, library_id) plus the guide URL. Filter by slug, persona, or category. Names and provenance only — no passages.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"slug": {
"type": "string",
"description": "One guide, e.g. start-a-company. When set, persona/category are ignored."
},
"limit": {
"type": "number",
"description": "Cap rows returned. Default 100, max 500."
},
"persona": {
"type": "string",
"description": "Audience filter, e.g. people-analytics-professional."
},
"category": {
"type": "string",
"description": "Subject shelf, e.g. field, skills, analytics."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_version",
"filters",
"count",
"total_matching",
"disagreements"
],
"properties": {
"count": {
"type": "number"
},
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"api_version": {
"type": "string"
},
"disagreements": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"poles",
"guide_slug",
"guide_url"
],
"properties": {
"name": {
"type": "string"
},
"poles": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"books"
],
"properties": {
"books": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"author",
"library_id"
],
"properties": {
"title": {
"type": "string"
},
"author": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"library_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"label": {
"type": "string"
}
},
"additionalProperties": false
}
},
"guide_url": {
"type": "string"
},
"guide_slug": {
"type": "string"
}
},
"additionalProperties": false
}
},
"total_matching": {
"type": "number"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}list_conditions — List organizational conditions
List organizational conditions (identity, label, guide count, causal-role counts). Filter by draft domain, subdomain, or causal_role (driver|mediator|outcome). Names and counts only — no addresses, no passages.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"description": "Substring match on the condition label."
},
"id": {
"type": "string",
"description": "Exact condition_identity_id. When set, other filters are ignored."
},
"limit": {
"type": "number",
"description": "Cap rows returned. Default 100, max 500."
},
"domain": {
"type": "string",
"description": "Draft domain slug, e.g. organizational-structure-and-culture."
},
"subdomain": {
"type": "string",
"description": "Draft sub-domain slug, e.g. organizational-learning-and-improvement."
},
"causal_role": {
"type": "string",
"description": "driver | mediator | outcome. Unknown values match nothing."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"api_version",
"address_status",
"filters",
"count",
"total_matching",
"taxonomy",
"conditions"
],
"properties": {
"count": {
"type": "number"
},
"filters": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"taxonomy": {
"type": "object",
"required": [
"domains",
"subdomains",
"identities"
],
"properties": {
"domains": {
"type": "number"
},
"identities": {
"type": "number"
},
"subdomains": {
"type": "number"
}
},
"additionalProperties": false
},
"conditions": {
"type": "array",
"items": {
"type": "object",
"required": [
"condition_identity_id",
"label",
"guide_corroboration_count",
"causal_roles",
"domain",
"subdomain"
],
"properties": {
"label": {
"type": "string"
},
"domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"subdomain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"causal_roles": {
"type": "object",
"required": [
"driver",
"mediator",
"outcome"
],
"properties": {
"driver": {
"type": "number"
},
"outcome": {
"type": "number"
},
"mediator": {
"type": "number"
}
},
"additionalProperties": false
},
"condition_identity_id": {
"type": "string"
},
"guide_corroboration_count": {
"type": "number"
}
},
"additionalProperties": false
}
},
"api_version": {
"type": "string"
},
"address_status": {
"type": "string",
"const": "draft"
},
"total_matching": {
"type": "number"
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}get_answer — Get an answer
Get one Answer — question, grounded answer, visible citations — by id or slug, in the Answer contract v0 shape (ANSWERS-PROGRAM.md). Read-only. Returns null if not found.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The Answer's stable id or slug."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"answer"
],
"properties": {
"answer": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_answers — List answers
List Answers (contract v0), paginated with an opaque cursor. Read-only.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"description": "Max answers to return (default: loader's choice, capped 200).",
"exclusiveMinimum": 0
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor from a previous list_answers call's nextCursor."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"items",
"nextCursor"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"nextCursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_answers — Search answers
Search Answers by free-text query over question/answer text. Returns contract v0 records. Read-only.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"description": "Max results to return (default: loader's choice, capped 200).",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"minLength": 1,
"description": "Free-text query matched against question/answer text."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
},
"additionalProperties": false
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 613 ms
- 95th percentile latency
- 613 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 613 ms · metadata changed · 10 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http the-talk-guide-mcp https://thetalk.guide/mcpCodex
codex mcp add the-talk-guide-mcp --url https://thetalk.guide/mcpCursor
{
"mcpServers": {
"the-talk-guide-mcp": {
"url": "https://thetalk.guide/mcp"
}
}
}Cline
{
"mcpServers": {
"the-talk-guide-mcp": {
"type": "streamableHttp",
"url": "https://thetalk.guide/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"the-talk-guide-mcp": {
"type": "http",
"url": "https://thetalk.guide/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http the-talk-guide-mcp https://thetalk.guide/mcpClaude Desktop
https://thetalk.guide/mcpWindsurf
{
"mcpServers": {
"the-talk-guide-mcp": {
"serverUrl": "https://thetalk.guide/mcp"
}
}
}Let your agent find its tools
Find servers like The Talk Guide MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other documentation and reference servers
Do you run The Talk Guide MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.