# Nous-approved MCP catalog entry.
# Presence in this directory = approval. Merged via PR review.
manifest_version: 1

name: postman
description: Postman workspaces, collections, environments, and APIs.
source: https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server/

# Official vendor-hosted remote MCP (URL-only — Hermes never spawns a local
# process for this entry). Native OAuth 2.1 + Dynamic Client Registration
# (verified live: RFC 9728 protected-resource metadata -> AS metadata with
# registration_endpoint); Hermes's MCP client + mcp_oauth_manager handle
# discovery, PKCE, token exchange, and refresh.

transport:
  type: http
  # /minimal is Postman's own documented essential-CRUD variant (collections,
  # workspaces, environments). The Full variant at /mcp is 100+ tools with
  # Enterprise surface; switch mcp_servers.postman.url if you need it.
  url: https://mcp.postman.com/minimal

auth:
  type: oauth

# Composer-suggestion triggers (desktop brand pills).
suggest:
  keywords:
    - postman
    - api collection
  hosts:
    - postman.com

post_install: |
  On first connection Hermes opens a browser to authorize with
  Postman (or run `hermes mcp login postman`). Approve access,
  then restart the session so tools load.