Step 0/8 · 0/0 checks

Artemis Mission Control

API & MCP Workshop

Your hands-on guide to Git-native API workflows, AI-powered testing, and MCP agent integration.

Workshop Resources

Workshop Materials
📦
API Git Repo
Postman
Postman Workspace
⬇️
Download Code (ZIP)
📄
OpenAPI Spec
🚀
Hosted API URL
📊
Workshop Slides
Tools & References
🤖
Meet Agent Mode
💡
Prompt Library
🔌
Postman MCP Server
🧩
Claude Code Plugin

Part 1 — Git-Native API Workflow

1
Create a Blank Workspace
  1. Sign in or sign up at postman.com.
  2. Create a new Blank Workspace.
  3. Name it: Artemis II - [your name]
2
Import the OpenAPI Spec
  1. Click the + icon → Import.
  2. Paste this URL and click Import:
https://raw.githubusercontent.com/mishra-aanchal/artemis-mission-control-api-workshop/refs/heads/main/openapi.yaml
  1. Postman auto-generates a collection from the spec.
3
Create the Environment with Agent Mode
  1. Open Agent Mode (the AI chat panel in Postman).
  2. Use this prompt:
🤖 Agent Mode Prompt
Create an environment called artemis.local with variables - baseUrl, apiKey and logId.
4
Update the Environment Variable
  1. Click on the artemis.local environment.
  2. Set baseUrl to:
https://artemis.up.railway.app
  1. Mark apiKey as secret (so it's hidden when screen-sharing).

Part 2 — Artemis Mission Control Workflow

5
Health Check & Registration

5A — Verify the API is Running

  1. Open the Health Check request in the collection.
  2. Click Send.
  3. Expect a 200 OK response.
📖 Self-guided references:
Simple guide: artemis.up.railway.app/guide/story

5B — Register as Crew Member

  1. Open Register Crew Member (POST /register).
  2. Go to the Body tab, enter:
{
  "name": "Your Name",
  "email": "your.email@example.com"
}
  1. Click Send.
  2. You'll receive your callsign, API key, and sigil (SVG badge).
⚠️ Using {{$randomEmail}} creates a new user every time — use your real email.
⚠️ If you re-send with the same email, the API returns the previous API key.
6
Auto-Save API Key with Agent Mode
  1. Stay on the Register Crew Member request.
  2. Open a new chat in Agent Mode.
  3. Drag and drop the Register request into the chat.
  4. Enter this prompt:
🤖 Agent Mode Prompt
Generate a script to save the api key from response to the environment variable apiKey
  1. Re-send the Register request to trigger the script.
  2. Verify: open your Environment — apiKey should be populated.
  3. Test it: Open Get Mission Overview (GET /mission) → Send → should return 200 OK.
Check that apiKey is set in the environment and the request header uses x-api-key: {{apiKey}}. Also ensure the environment is selected in the top-right dropdown.
7
Build a Mission Dashboard
  1. Stay on Get Mission Overview.
  2. Open Agent Mode, drag the request into the chat.
  3. Enter this prompt:
🤖 Agent Mode Prompt
Create a card-style visualisation by rendering the SVG as HTML rather than an image. Keep all the fields in the card. Make it like a mission dashboard;
  1. Send the request again.
  2. In the response panel, click the Visualize tab.
💡 Results vary since LLM outputs differ. Tell Agent Mode what to fix: "Make the sigil bigger" or "Add a progress percentage."
5
Documentation + Mission Log Blitz
📋 How this step works: Start documentation generation first — it runs in the background while you create your 3 mission logs.
Docs generating in background...

Part A — Start Documentation (Background)

  1. Open Agent Mode (new chat).
  2. Drag and drop your entire collection into the chat.
  3. Enter this prompt:
🤖 Agent Mode Prompt
Add documentation for this collection. Refer to the spec for specific examples
  1. Let it run — do not wait for it to finish. Move on to Part B immediately.
💡 Postman handles docs generation and your API requests in parallel. By the time you finish your 3 logs, the docs will likely be done.

Part B — Mission Log Blitz: Create 3 Logs

You need 3 mission logs with different categories to advance your mission. Send them one by one using POST /logs.

  1. Go to the Logs folder in your collection.
  2. Open Create Mission Log (POST /logs).
  3. Work through each log below.
🚀 Logs: 0 of 3 complete
🚀 1/3 Pre-Launch Navigation Check
Your crew is verifying star tracker alignment before leaving Earth orbit.

Go to the Body tab, paste the following, and click Send:

{
  "title": "Pre-flight navigation check complete",
  "description": "All star trackers aligned and verified for lunar transit",
  "phase": "pre-launch",
  "category": "navigation",
  "crew_member": "wiseman"
}

Expected: 201 Created. Note the log.id in the response — you'll need it later.

🚀 2/3 Life Support Systems Check
Mid-flight, Koch runs maintenance on the CO2 scrubbers to keep the cabin air breathable.

Replace the body with the following and click Send:

{
  "title": "CO2 scrubber maintenance",
  "description": "Replaced CO2 scrubber filter cartridge B. Cabin pressure nominal at 14.7 psi.",
  "phase": "launch",
  "category": "life-support",
  "crew_member": "koch"
}

Expected: 201 Created.

🚀 3/3 Deep Space Comms Handoff
Glover tests the antenna handoff to NASA's Deep Space Network as the crew moves beyond Earth-orbit range.

Replace the body with the following and click Send:

{
  "title": "Deep Space Network handoff test",
  "description": "Successfully switched primary comms from TDRS to DSN Madrid station. Signal strength 4.2 dBW.",
  "phase": "transit",
  "category": "communication",
  "crew_member": "glover"
}

Expected: 201 Created.

Use this reference to craft a custom log:

FieldAllowed Values
phasepre-launch, launch, transit, lunar-approach, orbit
categorynavigation, life-support, communication, science, anomaly, crew-status
crew_memberwiseman, glover, koch, hansen

Full sample list: artemis.up.railway.app/guide/logs

⚠️ Logs with category "anomaly" cannot be deleted — only updated. Anomalies are permanent mission records.

Part A Check-In — Documentation Done?

Head back to your Agent Mode chat. If docs are done, browse your collection and check that requests now have descriptions and example payloads.

6
Complete Your Mission — Update, Brief, Splashdown

You've created 3 logs. Now finish the remaining mission requirements.

#RequirementStatusRequest
13+ logs created✅ Done
2Update at least one log⬇️ Do nowPATCH /logs/:id
3Delete a log⬇️ Do nowDELETE /logs/:id
4Get a mission briefing⬇️ Do nowPOST /mission/brief
5Verify splashdown⬇️ Do nowGET /mission

6A — Update a Log

  1. List your logs: send GET /logs to see all your entries.
  2. Pick a log ID (or use the one from Log 1).
  3. Open Update Mission Log (PATCH /logs/:id).
  4. Replace :id in the URL with your actual log ID.
  5. Set the body:
{
  "title": "Pre-flight navigation check complete — VERIFIED BY FLIGHT DIRECTOR",
  "description": "All star trackers aligned. Secondary backup nav confirmed. Ready for TLI burn."
}
  1. Click Send — expect 200 OK.

6B — Delete a Log

  1. Delete one of the logs you created using the log ID from a previous request.
  2. Open Delete Mission Log (DELETE /logs/:id).
  3. Replace :id in the URL with your actual log ID.
  4. Click Send — expect 200 OK.
⚠️ Logs with category "anomaly" cannot be deleted — only updated. Choose a non-anomaly log.

6C — Request a Mission Briefing

  1. Open POST /mission/brief.
  2. Set the body to:
{}
  1. Click Send — expect a briefing response summarizing your mission status.

6D — Verify Splashdown 🎯

  1. Open GET /mission and click Send.
  2. Look for completion_percentage: 100 and all steps showing completed: true.
🎉 If you see 100% — congratulations, you've achieved splashdown! If not, check which step is incomplete in the response and go back to address it.
7
Generate an Integration Test Suite
  1. Start a new chat in Agent Mode.
  2. Drag and drop your collection into the chat.
  3. Enter this prompt:
🤖 Agent Mode Prompt
Generate a new collection to do an end-to-end integration test

- Refer to example responses for data to be sent in the body.
- Refer to the collection attached for the request type and add scripts
  to chain data between the requests.
- Create an environment "artemis.test" (baseUrl: https://artemis.up.railway.app)

Flow:
1. Register crew member (POST /register) — save api_key & callsign
2. Generate Mission Briefing (POST /mission/brief) with phase: transit
3. Get Mission Overview (GET /mission)
4. Create 3 mission logs (POST /logs) — save each log ID (path is response.log.id)
   Crew: wiseman, glover, koch, hansen
   Category: navigation, life-support, communication, science, crew-status, anomaly
5. Update one log (PATCH /logs/{logId1}) — category to science
6. Delete communication log (DELETE /logs/{logId2})
7. Generate final briefing (POST /mission/brief) with empty body
8. Verify mission completion (GET /mission) — all steps completed: true

Do not write tests yet — we will add them subsequently.
  1. Run the collection using the Collection Runner — verify green checkmarks.
  2. Then, in the same chat, enter:
🤖 Agent Mode Prompt
Run the collection using the collection runner and add integration tests based on the responses.
💡 If tests fail, paste the error into Agent Mode: "This test is failing with [error]. Debug it."
8
MCP — Connect an AI Agent to Your API
🔌 What is MCP? MCP (Model Context Protocol) turns your Postman collection into tools that an AI agent (like Claude) can call. The agent reads the collection, understands the endpoints, and calls them based on natural language.

Setup

  1. Install Postman's official MCP server in your AI tool (Claude Desktop, etc.).
  2. Generate a Postman API key at: go.postman.co/settings/me/api-keys
  3. Add the key to your MCP server configuration.

Try It — Send This to Claude

🤖 MCP Prompt
Check the Artemis leaderboard from my Postman collection id - <your collection id>
and tell me status of all participants progress.

More MCP Commands to Try

"What's the status of my mission?"Calls GET /mission and summarizes progress
"Log a navigation anomaly for Koch"Calls POST /logs with the right body
"Give me a mission briefing"Calls POST /mission/brief and interprets it
"Update that anomaly - it's resolved"Calls PATCH /logs/:id with updated title
"Who's leading?"Calls GET /leaderboard and ranks everyone

Mission Complete

Splashdown confirmed. Welcome home, Flight Director.

You've completed all 8 steps of the Artemis Mission Control workshop.