{
  "info": {
    "name": "Perplexity AI — mcp.ai",
    "description": "REST API for the Perplexity AI MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/perplexityai",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "perplexityai_create_async_chat_completion",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/async/chat/completion",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "async",
            "chat",
            "completion"
          ]
        },
        "description": "Create Async Chat Completion (POST /v1/async/sonar). Submits an asynchronous chat completion request for long-running tasks. Returns immediately with a request ID that can be polled using the Get Asyn",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"request\": {},\n  \"idempotency_key\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "perplexityai_create_chat_completion",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/chat/completion",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "chat",
            "completion"
          ]
        },
        "description": "Perplexity Sonar Chat Completions (POST /v1/sonar). Generates web-grounded conversational AI responses with citations. Supports multiple Sonar models optimized for different use cases: - sonar: Fast, ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"stop\": \"\",\n  \"model\": \"\",\n  \"top_p\": 0,\n  \"stream\": false,\n  \"messages\": \"\",\n  \"max_tokens\": 0,\n  \"search_mode\": \"\",\n  \"stream_mode\": \"\",\n  \"temperature\": 0,\n  \"return_images\": false,\n  \"disable_search\": false,\n  \"response_format\": {},\n  \"reasoning_effort\": \"\",\n  \"web_search_options\": {},\n  \"image_domain_filter\": \"\",\n  \"image_format_filter\": \"\",\n  \"language_preference\": \"\",\n  \"search_domain_filter\": \"\",\n  \"search_recency_filter\": \"\",\n  \"search_language_filter\": \"\",\n  \"enable_search_classifier\": false,\n  \"return_related_questions\": false,\n  \"search_after_date_filter\": \"\",\n  \"last_updated_after_filter\": \"\",\n  \"search_before_date_filter\": \"\",\n  \"last_updated_before_filter\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "perplexityai_create_contextualized_embeddings",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/contextualized/embeddings",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "contextualized",
            "embeddings"
          ]
        },
        "description": "Create Contextualized Embeddings (POST /v1/contextualizedembeddings). Generates document-aware embeddings where chunks from the same document share context. Unlike standard embeddings, these recognize",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"input\": \"\",\n  \"model\": \"\",\n  \"dimensions\": 0,\n  \"encoding_format\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "perplexityai_create_embeddings",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/embeddings",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "embeddings"
          ]
        },
        "description": "Generate vector embeddings for independent texts (queries, sentences, documents). This action takes one or more input texts and generates vector embeddings using Perplexity AI's embedding models. Embe",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"input\": \"\",\n  \"model\": \"\",\n  \"dimensions\": 0,\n  \"encoding_format\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "perplexityai_execute_agent",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/execute/agent",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "execute",
            "agent"
          ]
        },
        "description": "Create Agent Response (POST /v1/agent). Orchestrates multi-step agentic workflows with built-in tools (web search, URL fetching, function calling), reasoning, and multi-model support. Streaming is not",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"input\": \"\",\n  \"model\": \"\",\n  \"tools\": \"\",\n  \"models\": \"\",\n  \"preset\": \"\",\n  \"max_steps\": 0,\n  \"reasoning\": {},\n  \"instructions\": \"\",\n  \"response_format\": {},\n  \"max_output_tokens\": 0,\n  \"language_preference\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "perplexityai_get_async_chat_completion",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/async/chat/completion",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "async",
            "chat",
            "completion"
          ]
        },
        "description": "Get Async Chat Completion (GET /v1/async/sonar/{id}). Retrieves the result of an asynchronous chat completion request by its ID. Use this to poll for the result after creating an async job. The respon",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"request_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "perplexityai_list_async_chat_completions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/async/chat/completions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "async",
            "chat",
            "completions"
          ]
        },
        "description": "List Async Chat Completions (GET /v1/async/sonar). Retrieves a list of all asynchronous chat completion requests for the authenticated user. Use this to see the status of all your pending, completed, ",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "perplexityai_list_models",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/models",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "models"
          ]
        },
        "description": "List Models (GET /v1/models). Lists models available for the Agent API. Returns model identifiers that can be used with the Agent endpoint. The response follows the OpenAI List Models format for compa",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "perplexityai_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search"
          ]
        },
        "description": "Search the Web (POST /search). Returns raw, ranked web search results directly from Perplexity's index without LLM processing. Faster and cheaper than chat completions when you need raw results. Suppo",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": \"\",\n  \"country\": \"\",\n  \"max_tokens\": 0,\n  \"max_results\": 0,\n  \"max_tokens_per_page\": 0,\n  \"search_domain_filter\": \"\",\n  \"search_recency_filter\": \"\",\n  \"search_language_filter\": \"\",\n  \"search_after_date_filter\": \"\",\n  \"last_updated_after_filter\": \"\",\n  \"search_before_date_filter\": \"\",\n  \"last_updated_before_filter\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}