Skip to content
Back to search

model-context-protocol-resources

Exploring the Model Context Protocol (MCP) through practical guides, clients, and servers I've built while learning about this new protocol.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cyanheads--model-context-protocol-resources/badge.svg)](/listings/cyanheads--model-context-protocol-resources)

HTML

<a href="/listings/cyanheads--model-context-protocol-resources"><img src="/api/listings/cyanheads--model-context-protocol-resources/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 61 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <h1>Model Context Protocol (MCP)</h1>
  3. <p><b>A technical overview of the protocol, current to the 2026-07-28 specification.</b></p>
  4. </div>
  5. <div align="center">
  6. [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2026--07--28-8A2BE2.svg?style=flat-square)](https://modelcontextprotocol.io/specification/2026-07-28) [![Updated](https://img.shields.io/badge/Updated-October%202026-blue.svg?style=flat-square)](#) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE)
  7. </div>
  8. The [MCP overview](guides/mcp-overview.md) explains how MCP works: the roles, the wire format, what a server exposes, how servers ask for input, the transports, authorization, and what changed when the protocol went stateless in revision `2026-07-28`. It is written for engineers who want a working model of the protocol before reading the [specification](https://modelcontextprotocol.io/specification/2026-07-28).
  9. **Building a server?** [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core) is an agent-native TypeScript framework for building MCP servers on the current spec. Every scaffold ships Agent Skills that your coding agent follows to design, test, and release the server, and the server answers legacy and modern clients alike. Scaffold a project with:
  10. ```bash
  11. bunx @cyanheads/mcp-ts-core init my-mcp-server
  12. ```
  13. **Looking for working servers?** The servers I maintain are listed on my [GitHub profile](https://github.com/cyanheads). The [Fleet Map](https://fleet.caseyjhand.com) lists every hosted one with its tools, endpoint, and install snippets.
  14. ## Guides
  15. | Guide | Covers |
  16. |:--|:--|
  17. | [MCP overview](guides/mcp-overview.md) | Hosts, clients, and servers; messages and statelessness; tools, resources, and prompts; multi round-trip requests; notifications and caching; stdio and Streamable HTTP; authorization; extensions; security |
  18. | [Legacy vs. modern servers](guides/legacy-vs-modern.md) | Revision history from `2024-11-05`, what changed in `2026-07-28`, deprecations, era compatibility and detection, and a migration checklist for server authors |
  19. ## Agent Skills for server builders
  20. These skills ship with mcp-ts-core and are written for coding agents. They reference the framework's APIs, but the practices carry over to any SDK. Hand one to your agent and ask it to distill the guidance for your stack.
  21. | Looking to… | Skill |
  22. |:--|:--|
  23. | Design an MCP server: tool surface, resources, and service layer for a domain or API | [`design-mcp-server`](https://github.com/cyanheads/mcp-ts-core/blob/main/framework-skills/design-mcp-server/SKILL.md) |
  24. | Build a good tool: naming, schemas, response design, errors | [`add-tool`](https://github.com/cyanheads/mcp-ts-core/blob/main/framework-skills/add-tool/SKILL.md) |
  25. | Audit how your tool descriptions and schemas read to a model | [`tool-defs-analysis`](https://github.com/cyanheads/mcp-ts-core/blob/main/framework-skills/tool-defs-analysis/SKILL.md) |
  26. | Shape large or awkward responses: overflow handling, payload shaping, retrieval patterns | [`techniques`](https://github.com/cyanheads/mcp-ts-core/blob/main/framework-skills/techniques/SKILL.md) |
  27. | Test a server against live inputs, including adversarial ones | [`field-test`](https://github.com/cyanheads/mcp-ts-core/blob/main/framework-skills/field-test/SKILL.md) |
  28. | Review a server for security gaps: prompt injection, input sinks, auth, leakage | [`security-pass`](https://github.com/cyanheads/mcp-ts-core/blob/main/framework-skills/security-pass/SKILL.md) |
  29. ## Official resources
  30. | Resource | Link |
  31. |:--|:--|
  32. | Specification (`2026-07-28`) | [modelcontextprotocol.io/specification/2026-07-28](https://modelcontextprotocol.io/specification/2026-07-28) |
  33. | Changelog for this revision | [Key changes](https://modelcontextprotocol.io/specification/2026-07-28/changelog) |
  34. | Deprecated features registry | [Deprecated](https://modelcontextprotocol.io/specification/2026-07-28/deprecated) |
  35. | Schema (source of truth) | [`schema.ts`](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/schema/2026-07-28/schema.ts) |
  36. | Extensions | [Extensions overview](https://modelcontextprotocol.io/extensions/overview) |
  37. | Enhancement proposals | [SEPs](https://modelcontextprotocol.io/seps) |
  38. | Server registry | [MCP Registry](https://modelcontextprotocol.io/registry/about) |
  39. | Debugging | [MCP Inspector](https://github.com/modelcontextprotocol/inspector) |
  40. Official SDKs: [TypeScript](https://github.com/modelcontextprotocol/typescript-sdk) · [Python](https://github.com/modelcontextprotocol/python-sdk) · [Go](https://github.com/modelcontextprotocol/go-sdk) · [Java](https://github.com/modelcontextprotocol/java-sdk) · [Kotlin](https://github.com/modelcontextprotocol/kotlin-sdk) · [C#](https://github.com/modelcontextprotocol/csharp-sdk) · [Rust](https://github.com/modelcontextprotocol/rust-sdk) · [Swift](https://github.com/modelcontextprotocol/swift-sdk) · [Ruby](https://github.com/modelcontextprotocol/ruby-sdk) · [PHP](https://github.com/modelcontextprotocol/php-sdk)
  41. ---
  42. <div align="center">
  43. Maintained by <a href="https://github.com/cyanheads">cyanheads</a>. Independent of the Model Context Protocol project. Apache 2.0.
  44. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.