1) Verify service health
Ensure your target ProofMap environment is reachable.
export PROOFMAP_BASE_URL="https://your-proofmap-host"
curl -sS "$PROOFMAP_BASE_URL/api/health"Developers
Quickstart
Run these examples to validate connectivity, auth, and one production prompt-resolution call in just a few minutes.
2) Verify authenticated identity
Use your bearer token and confirm who the server sees.
export PROOFMAP_TOKEN="YOUR_BEARER_TOKEN"
curl -sS \
-H "Authorization: Bearer $PROOFMAP_TOKEN" \
"$PROOFMAP_BASE_URL/api/mcp/whoami"3) Resolve a prompt package
Fetch the active prompt package for an objective and target runtime.
curl -sS -G \
-H "Authorization: Bearer $PROOFMAP_TOKEN" \
--data-urlencode "objective_id=YOUR_OBJECTIVE_ID" \
--data-urlencode "target_runtime_id=YOUR_TARGET_RUNTIME_ID" \
"$PROOFMAP_BASE_URL/api/v1/mapping/resolve"4) Create a delegated MCP session
Create a scoped session token for external agents that should not use your primary user token directly.
curl -sS \
-X POST \
-H "Authorization: Bearer $PROOFMAP_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "YOUR_WORKSPACE_ID",
"label": "local-agent-session",
"permission_scopes": [
{
"resource_type": "workspace",
"resource_id": "YOUR_WORKSPACE_ID",
"access_level": "read"
}
],
"ttl_minutes": 60
}' \
"$PROOFMAP_BASE_URL/api/mcp/sessions"