Postman Collection Import

Overview

Upload a Postman collection and BoostGPT automatically generates a working MCP server. Your custom integration is live in under 5 minutes.

Quick Start

Export from Postman

In Postman:

Select your collection
Click Export
Choose Collection v2.1
Save the JSON file

Create Server

Go to Dashboard -> MCP Servers
Click Create Server
Select Upload Postman Collection

Upload File

Drop your Postman collection JSON file

Server Generated

BoostGPT generates your MCP server:

https://mcp.your-server-id.boostgpt.co

Connect to Agent

Agent -> Tools tab -> Add Tool -> Add New
Enter your MCP URL
Ready to use!

Postman Collection Format

Your collection should be in Postman Collection v2.1 format:

{
  "info": {
    "name": "My API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Get Users",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "https://api.example.com/users?limit=10",
          "host": ["api", "example", "com"],
          "path": ["users"],
          "query": [
            {
              "key": "limit",
              "value": "10"
            }
          ]
        }
      }
    },
    {
      "name": "Create User",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\"name\": \"John\", \"email\": \"john@example.com\"}"
        },
        "url": "https://api.example.com/users"
      }
    }
  ]
}

Auto-Generated Tools

Each Postman request becomes an agent tool:

Postman Request	Generated Tool	Description
GET /users	`get_users`	Fetches user list
POST /users	`create_user`	Creates new user
GET /users/:id	`get_user_by_id`	Gets single user
PUT /users/:id	`update_user`	Updates user info
DELETE /users/:id	`delete_user`	Deletes user

Example: E-commerce API

Postman Collection:

{
  "info": {
    "name": "E-commerce API"
  },
  "item": [
    {
      "name": "Get Products",
      "request": {
        "method": "GET",
        "url": "https://api.shop.com/products"
      }
    },
    {
      "name": "Create Order",
      "request": {
        "method": "POST",
        "url": "https://api.shop.com/orders",
        "body": {
          "mode": "raw",
          "raw": "{\"product_id\": \"123\", \"quantity\": 2}"
        }
      }
    },
    {
      "name": "Get Order Status",
      "request": {
        "method": "GET",
        "url": "https://api.shop.com/orders/:orderId"
      }
    }
  ]
}

Generated Tools:

Agent can now:

1. get_products
   - Lists available products

2. create_order
   - Parameters: product_id, quantity
   - Creates new order

3. get_order_status
   - Parameters: orderId
   - Checks order status

Authentication

Add authentication to your Postman collection:

API Key

{
  "auth": {
    "type": "apikey",
    "apikey": [
      {
        "key": "key",
        "value": "X-API-Key"
      },
      {
        "key": "value",
        "value": "{{api_key}}"
      }
    ]
  }
}

Bearer Token

{
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{access_token}}"
      }
    ]
  }
}

Configure credentials in Dashboard -> MCP Servers -> Your Server -> Settings

Variables

Use Postman variables for dynamic values:

{
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.example.com"
    },
    {
      "key": "api_key",
      "value": "your-api-key"
    }
  ]
}

Set variable values in MCP server settings after upload.

Testing

Test your MCP server:

User: "Get all products from the store"

Agent: *uses get_products tool*
       Found 50 products:
       1. Product A - $29.99
       2. Product B - $49.99
       ...

User: "Create an order for product 123, quantity 2"

Agent: *uses create_order tool*
       Order created successfully!
       Order ID: ORD-456

Organizing Collections

Use folders in Postman for better organization:

{
  "item": [
    {
      "name": "Users",
      "item": [
        {
          "name": "List Users",
          "request": {...}
        },
        {
          "name": "Create User",
          "request": {...}
        }
      ]
    },
    {
      "name": "Orders",
      "item": [
        {
          "name": "List Orders",
          "request": {...}
        }
      ]
    }
  ]
}

Tools are namespaced: users_list_users, orders_list_orders

Common Issues

Invalid collection format

Export as Collection v2.1 from Postman. Older formats aren’t supported.

Authentication not working

Add auth to your collection or configure credentials in MCP server settings after upload.

Request failing

Test requests in Postman first to ensure they work. Check URLs and parameters.

Variables not resolving

Set variable values in Dashboard -> MCP Servers -> Your Server -> Settings

Best Practices

Name requests clearly - “Get User” becomes get_user tool
Add descriptions - Help AI understand when to use each tool
Include examples - Add example requests in Postman
Test first - Verify requests work in Postman before uploading
Use folders - Organize related endpoints together
Document parameters - Add parameter descriptions in Postman

Example Collections

Download starter templates:

REST API Template - Basic CRUD operations
E-commerce Template - Product and order management
CRM Template - Contact and deal management

Next Steps

Authentication

Configure API authentication

OpenAPI Import

Alternative: Import OpenAPI spec

Getting Started

Choose Your Path

Providers & Models

Overview

Quick Start

Postman Collection Format

Auto-Generated Tools

Example: E-commerce API

Authentication

API Key

Bearer Token

Variables

Testing

Organizing Collections

Common Issues

Best Practices

Example Collections

Next Steps

Authentication

OpenAPI Import

​Overview

​Quick Start

​Postman Collection Format

​Auto-Generated Tools

​Example: E-commerce API

​Authentication

​API Key

​Bearer Token

​Variables

​Testing

​Organizing Collections

​Common Issues

​Best Practices

​Example Collections

​Next Steps

Authentication

OpenAPI Import

Overview

Quick Start

Postman Collection Format

Auto-Generated Tools

Example: E-commerce API

Authentication

API Key

Bearer Token

Variables

Testing

Organizing Collections

Common Issues

Best Practices

Example Collections

Next Steps