Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Postman MCP server

Vendor MCP
Open markdown

The Postman MCP connector routes your AI agent's tool calls to Postman's own MCP server through Scalekit. Each user signs in to Postman once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 41 tools.

Tools
41
What they doRead · write · destructive
20 · 21 · 020 read21 write0 destructive
Users sign in with
OAuth app
Scalekit's or your own

What you can do

  • Manage collections: create, get, replace, and duplicate collections, and add or update their requests and responses
  • Work with API specs: create and edit specifications and their files, and generate collections from specs or specs from collections
  • Manage environments: create, list, fetch, and replace environments and their variables
  • Run mock servers: create, update, publish, and list mock servers for collections
  • Organize workspaces: create, list, and update workspaces and search for requests, collections, and specs

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Create the Postman MCP connection

    In AgentKit > Connections, create a Postman MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Postman MCP server, so you don't need to register an OAuth app.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENVIRONMENT_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'postmanmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Postman MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'postmanmcp_getauthenticateduser',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • postmanmcp_getallspecsGets all API specifications in a workspace.Read-only

    Get All Specs

    Gets all API specifications in a workspace.

    Inputs

    workspaceIdstringrequired
    The workspace's ID.
    cursorstring
    The pointer to the first record of the set of paginated results. To view the next response, use the `nextCursor` value for this parameter.
    limitinteger
    The maximum number of rows to return in the response.default 10
  • postmanmcp_getauthenticateduserGets information about the authenticated user.Read-only

    Get Authenticated User

    Gets information about the authenticated user. - This endpoint provides “current user” context (\`user.id\`, \`username\`, \`teamId\`, roles). - When a user asks for “my …” (e.g., “my workspaces, my information, etc.”), call this first to resolve the user ID.

    Inputs

    This tool takes no inputs.

  • postmanmcp_getcollectionGet information about a collection.Read-only

    Get Collection

    Get information about a collection. By default this tool returns the lightweight collection map (metadata + recursive itemRefs). Use the model parameter to opt in to Postman's full API responses: - model=minimal — root-level folder/request IDs only - model=full — full Postman collection payload.

    Inputs

    collectionIdstringrequired
    The collection ID must be in the form <OWNER_ID>-<UUID> (e.g. 12345-33823532ab9e41c9b6fd12d0fd459b8b).
    access_keystring
    A collection's read-only access key. Using this query parameter does not require an API key to call the endpoint.
    modelstring
    Optional response shape override. Omit to receive the lightweight collection map. Set to `minimal` for the Postman minimal model or `full` for the complete collection payload.one of minimalfull
  • postmanmcp_getcollectionsThe workspace ID query is required for this endpoint.Read-only

    Get Collections

    The workspace ID query is required for this endpoint. If not provided, the LLM should ask the user to provide it.

    Inputs

    workspacestringrequired
    The workspace's ID.
    limitinteger
    The maximum number of rows to return in the response.
    namestring
    Filter results by collections whose name exactly matches the given value. Partial or substring matches are not supported.
    offsetinteger
    The zero-based offset of the first item to return.
  • postmanmcp_getduplicatecollectiontaskstatusGets the status of a collection duplication task.Read-only

    Get Duplicate Collection Task Status

    Gets the status of a collection duplication task.

    Inputs

    taskIdstringrequired
    The task's unique ID.
  • postmanmcp_getenabledtoolsIMPORTANT: Run this tool first when a requested tool is unavailable.Read-only

    Get Enabled Tools

    IMPORTANT: Run this tool first when a requested tool is unavailable. Returns information about which tools are enabled in the full and minimal tool sets, helping you identify available alternatives.

    Inputs

    This tool takes no inputs.

  • postmanmcp_getenvironmentGets information about an environment.Read-only

    Get Environment

    Gets information about an environment.

    Inputs

    environmentIdstringrequired
    The environment's ID.
  • postmanmcp_getenvironmentsGets information about all of your [environments](https://learning.postman.com/docs/sending-requests/managing-environments/).Read-only

    Get Environments

    Gets information about all of your [environments](https://learning.postman.com/docs/sending-requests/managing-environments/).

    Inputs

    workspacestring
    The workspace's ID.
All 94 in Developer Tools