• MAP
  • LIST
  • AUDIT
  • HUMAN

How to explore API schemas and collections with your AI

Connect your agent to Postman once. From there, it can navigate your workspaces and pull specific API details on command.

Ask AI about this page

Short answer

How can I use my AI to map my API architecture?

Your agent uses Postman to browse your workspaces and list every API and collection you have stored. This gives your AI the context it needs to understand your service structure. You get a clear map of your entire API landscape.

The outcomes.

Where your data lands.

Your agent turns Postman data into organized architectural knowledge.

MAP

Full service maps

The AI crawls your workspaces to build a picture of how your services connect. You get a bird's-eye view of your API ecosystem.

LIST

Endpoint inventories

Your agent pulls specific collections and API definitions. This creates a searchable list of every available endpoint.

AUDIT

Schema validation

By reading API definitions, your agent identifies patterns or missing documentation. It flags where your schemas might be inconsistent.

HUMAN

Manual updates

The AI can read and list everything, but it cannot edit your Postman collections. You still handle the actual documentation changes.

The workflow

What your AI does when the request arrives.

The agent moves through your Postman hierarchy to find the specific data you need.

  1. Locate workspaces

    The agent starts by identifying all available Postman workspaces to establish its scope.

    list_workspaces

  2. Inspect workspace content

    Once a workspace is selected, the agent looks inside to see what it contains.

    get_workspace_details

  3. Identify APIs

    The agent pulls a list of all API definitions within the target workspace.

    list_apis

  4. Catalog collections

    The agent finishes by listing every collection to ensure no endpoint is missed.

    list_collections

Try it

Copy these to start.

Use these prompts to begin your API discovery.

Starting points

These are opening lines. Swap out the workspace names for your actual Postman workspace titles.

Postman Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_0K4qtkIFA5sn8n9HRmta4uR6Lfy8jZ7oHngivRhy/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Postman capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "postman-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_0K4qtkIFA5sn8n9HRmta4uR6Lfy8jZ7oHngivRhy/mcp"
    }
  }
}
Copy into chat04

  • List all my Postman workspaces so I can see what's available.

  • Find the 'Payment Gateway' workspace and list all the APIs inside it.

  • Show me all the collections in my 'Production' workspace.

  • Summarize the API definitions found in my 'Internal Services' workspace.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Postman once, then ask.

Just link your account once. Your credentials stay encrypted, and you can immediately start asking your agent about your API structure.

Connect Postman to your AI

FAQ

How this task behaves.

  • 01

    Can the AI edit my Postman collections?

    No. The agent can only read and list your workspaces, APIs, and collections. You must make all changes manually in Postman.

  • 02

    Can the AI delete an API definition?

    No. This MCP is read-only. It cannot delete or modify any data in your Postman account.

  • 03

    Does the AI see my API keys?

    No. The agent only accesses the structural definitions and lists of your APIs and collections.

  • 04

    How does the AI know which workspace to look in?

    You tell it. You can ask it to list all workspaces first, or you can name a specific one in your prompt.

  • 05

    Can I use this with any AI client?

    Yes, as long as the client is MCP-compatible, like Claude, Cursor, or Windsurf.

  • More questions about Postman? See everything the Postman Connector can do

Connect Postman to Claude, Cursor, ChatGPT & more