Unlike every other page in this section, there’s no AI assistant here to type natural-language prompts into. You call each Perfai tool directly from Postman’s Tools tab, filling in its arguments yourself.
Get an API key
Perfai Cloud authenticates Postman with a Perfai API key. Create one and copy it — Perfai shows the full key only once. You’ll paste it into Postman’s Authorization tab as the Bearer token value.Installation
- In any Postman workspace, click Add → MCP.
- Set the transport: choose HTTP (Postman’s label for Streamable HTTP).
- URL:
https://mcp-server.perfai.ai/mcp - Open the Authorization tab → Auth Type: Bearer Token → paste your API key.
- Click Run to connect.
Verify the server is connected
- A valid key gets you a green Connected status immediately after clicking Run — the handshake doesn’t require you to already be logged into a Perfai account, only to send a valid key.
- Open the Tools tab and confirm all 19 tools are listed.
- If it fails, re-check the key for trailing whitespace. A
401means the key has expired or been revoked — create a new one and paste it into the Authorization tab.
The API key also signs you in: every tool runs as the user who created the key, with that user’s organizations and role. There is no separate
login step.Confirm you’re signed in
In the Tools tab, runauth_status. It shows the key’s id (pfk_xxxxxxxxxxxx_…), never the secret.
Register an app and run a scan
Run each of these from the Tools tab, filling in arguments as needed:register_app— setappUrltohttps://your-app.example.com.check_app_status— run repeatedly untilregistrationStatusisCOMPLETED. If it returnsNEEDS_INPUTwith reasonneeds_login, that’s the target app’s own login, not your Perfai account — supply it viasubmit_app_credentials.run_security_test— returns ataskId.check_task_status— run with thattaskIduntil it reportsCOMPLETED.get_vulnerabilities— lists findings with sequence numbers, used in the fix tools below.
Fix and verify
auto_fix_all— returns a prioritized, critical-first fix plan. Postman won’t apply these changes for you; copy the instructions into your editor by hand.mark_vulnerability_fixed— run once per finding, after the corresponding code change is actually made.get_fix_summary— confirms the fixed/unfixed/dismissed counts moved as expected.logout, thenauth_statusagain — confirms the session actually cleared.

