Artemis Mission Control
API & MCP Workshop
Your hands-on guide to Git-native API workflows, AI-powered testing, and MCP agent integration.
Workshop Resources
Part 1 — Git-Native API Workflow
- Sign in or sign up at postman.com.
- Create a new Blank Workspace.
- Name it: Artemis II - [your name]
- Click the + icon → Import.
- Paste this URL and click Import:
https://raw.githubusercontent.com/mishra-aanchal/artemis-mission-control-api-workshop/refs/heads/main/openapi.yaml
- Postman auto-generates a collection from the spec.
- Open Agent Mode (the AI chat panel in Postman).
- Use this prompt:
Create an environment called artemis.local with variables - baseUrl, apiKey and logId.
- Click on the artemis.local environment.
- Set baseUrl to:
https://artemis.up.railway.app
- Mark apiKey as secret (so it's hidden when screen-sharing).
Part 2 — Artemis Mission Control Workflow
5A — Verify the API is Running
- Open the Health Check request in the collection.
- Click Send.
- Expect a 200 OK response.
5B — Register as Crew Member
- Open Register Crew Member (POST /register).
- Go to the Body tab, enter:
{
"name": "Your Name",
"email": "your.email@example.com"
}
- Click Send.
- You'll receive your callsign, API key, and sigil (SVG badge).
- Stay on the Register Crew Member request.
- Open a new chat in Agent Mode.
- Drag and drop the Register request into the chat.
- Enter this prompt:
Generate a script to save the api key from response to the environment variable apiKey
- Re-send the Register request to trigger the script.
- Verify: open your Environment — apiKey should be populated.
- Test it: Open Get Mission Overview (GET /mission) → Send → should return 200 OK.
- Stay on Get Mission Overview.
- Open Agent Mode, drag the request into the chat.
- Enter this 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;
- Send the request again.
- In the response panel, click the Visualize tab.
Part A — Start Documentation (Background)
- Open Agent Mode (new chat).
- Drag and drop your entire collection into the chat.
- Enter this prompt:
Add documentation for this collection. Refer to the spec for specific examples
- Let it run — do not wait for it to finish. Move on to Part B immediately.
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.
- Go to the Logs folder in your collection.
- Open Create Mission Log (POST /logs).
- Work through each log below.
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.
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.
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:
| Field | Allowed Values |
|---|---|
| phase | pre-launch, launch, transit, lunar-approach, orbit |
| category | navigation, life-support, communication, science, anomaly, crew-status |
| crew_member | wiseman, glover, koch, hansen |
Full sample list: artemis.up.railway.app/guide/logs
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.
You've created 3 logs. Now finish the remaining mission requirements.
| # | Requirement | Status | Request |
|---|---|---|---|
| 1 | 3+ logs created | ✅ Done | — |
| 2 | Update at least one log | ⬇️ Do now | PATCH /logs/:id |
| 3 | Delete a log | ⬇️ Do now | DELETE /logs/:id |
| 4 | Get a mission briefing | ⬇️ Do now | POST /mission/brief |
| 5 | Verify splashdown | ⬇️ Do now | GET /mission |
6A — Update a Log
- List your logs: send GET /logs to see all your entries.
- Pick a log ID (or use the one from Log 1).
- Open Update Mission Log (PATCH /logs/:id).
- Replace :id in the URL with your actual log ID.
- 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."
}
- Click Send — expect 200 OK.
6B — Delete a Log
- Delete one of the logs you created using the log ID from a previous request.
- Open Delete Mission Log (DELETE /logs/:id).
- Replace :id in the URL with your actual log ID.
- Click Send — expect 200 OK.
6C — Request a Mission Briefing
- Open POST /mission/brief.
- Set the body to:
{}
- Click Send — expect a briefing response summarizing your mission status.
6D — Verify Splashdown 🎯
- Open GET /mission and click Send.
- Look for completion_percentage: 100 and all steps showing completed: true.
- Start a new chat in Agent Mode.
- Drag and drop your collection into the chat.
- Enter this 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.
- Run the collection using the Collection Runner — verify green checkmarks.
- Then, in the same chat, enter:
Run the collection using the collection runner and add integration tests based on the responses.
Setup
- Install Postman's official MCP server in your AI tool (Claude Desktop, etc.).
- Generate a Postman API key at: go.postman.co/settings/me/api-keys
- Add the key to your MCP server configuration.
Try It — Send This to Claude
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.