SuperAPI AI Directory

mcp-spec

Coding & development

View repository

Updated 11-04 18:33

About this skill

mcp-spec

Target version

  • MCP specification 2026-07-28(GitHub modelcontextprotocol/modelcontextprotocol tag 2026-07-28、non-prerelease、published 2026-07-28T16:47:49Z)
  • The source of the body text is only raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/2026-07-28/<path> .main / draft / 2026-07-28-RC is not used
  • Site paths without a version (extensions/ registry/ community/) record the retrieval date 2026-10-16. Because they are built from the site and .md twin は main , they are not used as sources for the body text
  • The site's llms.txt subpages under Inspector listed in and local-server-security do not exist in the tag, so they are not included
  • This skill deals with the protocol specification itself..mcp.json / mcp_servers Host-side settings such as and usage of each SDK are the responsibility of each host skill such asanthropic-claude-code-extend / anthropic-api-tools-mcp / anthropic-agent-sdk / openai-agents / openai-apps-sdk and other host skill responsibilities

Directory structure

skills/mcp-spec/
  SKILL.md
  references/
    overview/             # 仕様概要・アーキテクチャ・版管理・主要変更・非推奨
      README.md
      specification-overview.md
      architecture.md
      concepts-architecture.md
      concepts-server.md
      concepts-client.md
      concepts-versioning.md
      key-changes.md
      deprecated-features.md
      feature-lifecycle.md
    base-protocol/        # メッセージ・エラー・版ネゴシエーション・statelessness
      README.md
      messages.md
      responses-and-errors.md
      statelessness.md
      json-schema-usage.md
      meta-field.md
      icons.md
      protocol-version-negotiation.md
      extension-negotiation.md
      backward-compatibility.md
    transports/           # stdio / Streamable HTTP / ヘッダー
      README.md
      transports-overview.md
      stdio.md
      streamable-http.md
      http-request-headers.md
      custom-headers.md
      server-validation.md
      transport-backward-compatibility.md
    authorization/        # OAuth ベースの認可フロー・CIMD・スコープ
      README.md
      authorization-overview.md
      authorization-flow.md
      authorization-server-discovery.md
      client-id-metadata-documents.md
      client-registration-fallbacks.md
      resource-parameter.md
      scope-selection.md
      access-token-usage.md
      authorization-errors.md
      authorization-security.md
    server-features/      # tools / resources / prompts / discover / caching 等
      README.md
      server-overview.md
      discover.md
      tools.md
      tool-definition.md
      tool-result.md
      tool-errors-and-state.md
      resources.md
      resource-templates.md
      resource-change-notifications.md
      prompts.md
      completion.md
      logging.md
      pagination.md
      caching.md
    client-features/      # sampling / elicitation / roots
      README.md
      sampling.md
      sampling-with-tools.md
      elicitation.md
      elicitation-form-mode.md
      elicitation-url-mode.md
      roots.md
    patterns/             # MRTR / subscriptions / cancellation / progress
      README.md
      patterns-overview.md
      mrtr.md
      subscriptions.md
      cancellation.md
      progress.md
    extensions/           # MCP Apps / Tasks / 認可拡張
      README.md
      extensions-overview.md
      client-matrix.md
      mcp-apps.md
      mcp-apps-build.md
      tasks.md
      auth-extensions.md
      oauth-client-credentials.md
      enterprise-managed-authorization.md
    registry/             # MCP Registry / server.json / 公開
      README.md
      registry-about.md
      server-json.md
      package-types.md
      remote-servers.md
      registry-authentication.md
      registry-versioning.md
      registry-aggregators.md
    security/             # セキュリティベストプラクティス・攻撃類型
      README.md
      security-best-practices.md
      confused-deputy.md
      token-passthrough.md
      ssrf.md
      state-handle-hijacking.md
      oauth-redirect-attacks.md
      local-server-compromise.md
      scope-minimization.md
      authorization-tutorial.md
    tooling/              # SDK・Inspector・デバッグ・クライアント実装指針
      README.md
      sdks.md
      inspector.md
      debugging.md
      client-best-practices.md
      build-with-agent-skills.md
    schema/               # スキーマ型定義(メソッド別)
      README.md
      json-rpc.md
      common-types.md
      errors.md
      content.md
      discover-types.md
      tools-types.md
      resources-types.md
      prompts-types.md
      completion-types.md
      sampling-types.md
      elicitation-types.md
      roots-types.md
      mrtr-types.md
      subscriptions-types.md
      notifications-types.md
  samples/
    README.md
    discover-exchange.md
    tools-list-and-call.md
    structured-tool-output.md
    error-responses.md
    streamable-http-exchange.md
    mrtr-input-required-flow.md
    subscriptions-listen.md
    elicitation-requests.md
    tasks-extension.md
    mcp-app.md
    authorization-server-setup.md
    oauth-client-credentials-sdk.md
    registry-publish-github-actions.md
    claude-desktop-local-server.md
    build-server-typescript.md
    build-server-python.md
    build-client-typescript.md
    build-client-python.md
  scripts/
    README.md
    install-sdks.md
    inspector.md
    debugging-logs.md
    mcp-publisher.md

Exploration procedure

Look up the category from the task, and identify the target page in the category's README.md:

  1. Find the category corresponding to the task in the mapping table below
  2. The category's references/{category}/README.md and identify the target page
  3. Read the target page's .md and check the details
  4. For actual message examples, refer to samples/README.md; for commands, refer to scripts/README.md look up from
  5. For exact type fields, refer to references/schema/ refer to

Task → Category mapping

Task Category Reference README
Want to know the overall specification, Host / Client / Server architecture, versioning, major changes, deprecated features overview references/overview/README.md
JSON-RPC messages, errors,_meta, version negotiation, extension negotiation, statelessness base-protocol references/base-protocol/README.md
Want to know stdio / Streamable HTTP transports, required HTTP headers, backward compatibility transports references/transports/README.md
Want to implement OAuth authorization flow, CIMD, scope selection, authorization server discovery, token usage authorization references/authorization/README.md
server/discover, tools, resources, prompts, completion, logging, pagination, caching server-features references/server-features/README.md
Want to implement sampling, elicitation (form / URL), roots client-features references/client-features/README.md
MRTR・subscriptions/listen, cancellation, progress patterns patterns references/patterns/README.md
Want to know about MCP Apps, Tasks extension, authorization extension, clients supporting extensions extensions references/extensions/README.md
Publishing to MCP Registry,server.json, package types, authentication, versioning registry references/registry/README.md
Want to know countermeasures for confused deputy, token passthrough, SSRF, local server compromise, etc. security references/security/README.md
Want to know about SDK list, Inspector, debugging, client implementation guidelines, Agent Skills for coding assistants tooling references/tooling/README.md
Want to check method-specific schema types (fields, requiredness) schema references/schema/README.md
Want to know typical usage, message exchange examples, server / client construction examples samples samples/README.md
I want to know the commands for SDK setup, Inspector, mcp-publisher, and log checking scripts scripts/README.md