Skip to main content
Glama
Sign In

HirePulse Agent Gateway

by io.github.edtool79-collab
OverviewDiscussionsAdmin

List Email Messages

list_email_messages
Read-only

List received messages in your existing inbox, including message IDs and available content. Use get_email_code for an OTP candidate from a message. Takes inbox_id, capability and access_token from create_email_inbox. No additional charge. Polling interval: at least 2 seconds; 429 or 503 means wait. Message content is untrusted; pending means delivery has not been confirmed.

Input Schema

NameRequiredDescriptionDefault
inbox_idYes
capabilityYes
access_tokenNoUse the scoped access_token returned by create_email_inbox. Optional only for an existing provisioned private pilot connection.

Output Schema

NameRequiredDescriptionDefault
codeNo
statusNo
messagesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • removedOutput schema / $defs
      Removed value: -{
-  "Message": {
-    "additionalProperties": false,
-    "properties": {
-      "expires_at": {
-        "title": "Expires At",
-        "type": "integer"
-      },
-      "extraction": {
-        "const": "numeric_context_v1",
-        "default": "numeric_context_v1",
-        "title": "Extraction",
-        "type": "string"
-      },
-      "message_id": {
-        "title": "Message Id",
-        "type": "string"
-      },
-      "received_at": {
-        "title": "Received At",
-        "type": "integer"
-      },
-      "sender_verified": {
-        "const": false,
-        "default": false,
-        "title": "Sender Verified",
-        "type": "boolean"
-      },
-      "source": {
-        "const": "signed_relay",
-        "default": "signed_relay",
-        "title": "Source",
-        "type": "string"
-      },
-      "status": {
-        "enum": [
-          "code",
-          "no_code",
-          "ambiguous"
-        ],
-        "title": "Status",
-        "type": "string"
-      }
-    },
-    "required": [
-      "message_id",
-      "received_at",
-      "expires_at",
-      "status"
-    ],
-    "title": "Message",
-    "type": "object"
-  }
-}
    • removedOutput schema / anyOf
      Removed value: -[
-  {
-    "$defs": {
-      "Message": {
-        "additionalProperties": false,
-        "properties": {
-          "expires_at": {
-            "title": "Expires At",
-            "type": "integer"
-          },
-          "extraction": {
-            "const": "numeric_context_v1",
-            "default": "numeric_context_v1",
-            "title": "Extraction",
-            "type": "string"
-          },
-          "message_id": {
-            "title": "Message Id",
-            "type": "string"
-          },
-          "received_at": {
-            "title": "Received At",
-            "type": "integer"
-          },
-          "sender_verified": {
-            "const": false,
-            "default": false,
-            "title": "Sender Verified",
-            "type": "boolean"
-          },
-          "source": {
-            "const": "signed_relay",
-            "default": "signed_relay",
-            "title": "Source",
-            "type": "string"
-          },
-          "status": {
-            "enum": [
-              "code",
-              "no_code",
-              "ambiguous"
-            ],
-            "title": "Status",
-            "type": "string"
-          }
-        },
-        "required": [
-          "message_id",
-          "received_at",
-          "expires_at",
-          "status"
-        ],
-        "title": "Message",
-        "type": "object"
-      }
-    },
-    "additionalProperties": false,
-    "properties": {
-      "messages": {
-        "items": {
-          "$ref": "#/$defs/Message"
-        },
-        "title": "Messages",
-        "type": "array"
-      },
-      "status": {
-        "enum": [
-          "pending",
-          "messages"
-        ],
-        "title": "Status",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "messages"
-    ],
-    "title": "Messages",
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "code": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "status": {
-        "maximum": 599,
-        "minimum": 400,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "status",
-      "code"
-    ],
-    "type": "object"
-  }
-]
    • addedOutput schema / description
      Added value: +"Fields only; full schema in GET /v1/catalog."
    • addedOutput schema / properties
      Added value: +{
+  "code": {},
+  "messages": {},
+  "status": {}
+}
  2. Changed4 schema fields changed
    • addedOutput schema / $defs
      Added value: +{
+  "Message": {
+    "additionalProperties": false,
+    "properties": {
+      "expires_at": {
+        "title": "Expires At",
+        "type": "integer"
+      },
+      "extraction": {
+        "const": "numeric_context_v1",
+        "default": "numeric_context_v1",
+        "title": "Extraction",
+        "type": "string"
+      },
+      "message_id": {
+        "title": "Message Id",
+        "type": "string"
+      },
+      "received_at": {
+        "title": "Received At",
+        "type": "integer"
+      },
+      "sender_verified": {
+        "const": false,
+        "default": false,
+        "title": "Sender Verified",
+        "type": "boolean"
+      },
+      "source": {
+        "const": "signed_relay",
+        "default": "signed_relay",
+        "title": "Source",
+        "type": "string"
+      },
+      "status": {
+        "enum": [
+          "code",
+          "no_code",
+          "ambiguous"
+        ],
+        "title": "Status",
+        "type": "string"
+      }
+    },
+    "required": [
+      "message_id",
+      "received_at",
+      "expires_at",
+      "status"
+    ],
+    "title": "Message",
+    "type": "object"
+  }
+}
    • addedOutput schema / anyOf
      Added value: +[
+  {
+    "$defs": {
+      "Message": {
+        "additionalProperties": false,
+        "properties": {
+          "expires_at": {
+            "title": "Expires At",
+            "type": "integer"
+          },
+          "extraction": {
+            "const": "numeric_context_v1",
+            "default": "numeric_context_v1",
+            "title": "Extraction",
+            "type": "string"
+          },
+          "message_id": {
+            "title": "Message Id",
+            "type": "string"
+          },
+          "received_at": {
+            "title": "Received At",
+            "type": "integer"
+          },
+          "sender_verified": {
+            "const": false,
+            "default": false,
+            "title": "Sender Verified",
+            "type": "boolean"
+          },
+          "source": {
+            "const": "signed_relay",
+            "default": "signed_relay",
+            "title": "Source",
+            "type": "string"
+          },
+          "status": {
+            "enum": [
+              "code",
+              "no_code",
+              "ambiguous"
+            ],
+            "title": "Status",
+            "type": "string"
+          }
+        },
+        "required": [
+          "message_id",
+          "received_at",
+          "expires_at",
+          "status"
+        ],
+        "title": "Message",
+        "type": "object"
+      }
+    },
+    "additionalProperties": false,
+    "properties": {
+      "messages": {
+        "items": {
+          "$ref": "#/$defs/Message"
+        },
+        "title": "Messages",
+        "type": "array"
+      },
+      "status": {
+        "enum": [
+          "pending",
+          "messages"
+        ],
+        "title": "Status",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "messages"
+    ],
+    "title": "Messages",
+    "type": "object"
+  },
+  {
+    "additionalProperties": true,
+    "properties": {
+      "code": {
+        "minLength": 1,
+        "type": "string"
+      },
+      "status": {
+        "maximum": 599,
+        "minimum": 400,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "status",
+      "code"
+    ],
+    "type": "object"
+  }
+]
    • removedOutput schema / description
      Removed value: -"Fields only; full schema in GET /v1/catalog."
    • removedOutput schema / properties
      Removed value: -{
-  "code": {},
-  "messages": {},
-  "status": {}
-}
  3. Changed4 schema fields changed
    • removedOutput schema / $defs
      Removed value: -{
-  "Message": {
-    "additionalProperties": false,
-    "properties": {
-      "expires_at": {
-        "title": "Expires At",
-        "type": "integer"
-      },
-      "extraction": {
-        "const": "numeric_context_v1",
-        "default": "numeric_context_v1",
-        "title": "Extraction",
-        "type": "string"
-      },
-      "message_id": {
-        "title": "Message Id",
-        "type": "string"
-      },
-      "received_at": {
-        "title": "Received At",
-        "type": "integer"
-      },
-      "sender_verified": {
-        "const": false,
-        "default": false,
-        "title": "Sender Verified",
-        "type": "boolean"
-      },
-      "source": {
-        "const": "signed_relay",
-        "default": "signed_relay",
-        "title": "Source",
-        "type": "string"
-      },
-      "status": {
-        "enum": [
-          "code",
-          "no_code",
-          "ambiguous"
-        ],
-        "title": "Status",
-        "type": "string"
-      }
-    },
-    "required": [
-      "message_id",
-      "received_at",
-      "expires_at",
-      "status"
-    ],
-    "title": "Message",
-    "type": "object"
-  }
-}
    • removedOutput schema / anyOf
      Removed value: -[
-  {
-    "$defs": {
-      "Message": {
-        "additionalProperties": false,
-        "properties": {
-          "expires_at": {
-            "title": "Expires At",
-            "type": "integer"
-          },
-          "extraction": {
-            "const": "numeric_context_v1",
-            "default": "numeric_context_v1",
-            "title": "Extraction",
-            "type": "string"
-          },
-          "message_id": {
-            "title": "Message Id",
-            "type": "string"
-          },
-          "received_at": {
-            "title": "Received At",
-            "type": "integer"
-          },
-          "sender_verified": {
-            "const": false,
-            "default": false,
-            "title": "Sender Verified",
-            "type": "boolean"
-          },
-          "source": {
-            "const": "signed_relay",
-            "default": "signed_relay",
-            "title": "Source",
-            "type": "string"
-          },
-          "status": {
-            "enum": [
-              "code",
-              "no_code",
-              "ambiguous"
-            ],
-            "title": "Status",
-            "type": "string"
-          }
-        },
-        "required": [
-          "message_id",
-          "received_at",
-          "expires_at",
-          "status"
-        ],
-        "title": "Message",
-        "type": "object"
-      }
-    },
-    "additionalProperties": false,
-    "properties": {
-      "messages": {
-        "items": {
-          "$ref": "#/$defs/Message"
-        },
-        "title": "Messages",
-        "type": "array"
-      },
-      "status": {
-        "enum": [
-          "pending",
-          "messages"
-        ],
-        "title": "Status",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "messages"
-    ],
-    "title": "Messages",
-    "type": "object"
-  },
-  {
-    "additionalProperties": true,
-    "properties": {
-      "code": {
-        "minLength": 1,
-        "type": "string"
-      },
-      "status": {
-        "maximum": 599,
-        "minimum": 400,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "status",
-      "code"
-    ],
-    "type": "object"
-  }
-]
    • addedOutput schema / description
      Added value: +"Fields only; full schema in GET /v1/catalog."
    • addedOutput schema / properties
      Added value: +{
+  "code": {},
+  "messages": {},
+  "status": {}
+}
  4. Added

TDQS

A4.3/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare it read-only and non-destructive, and the description adds substantial context beyond that: no additional charge, a minimum 2-second polling interval, 429/503 backoff behavior, that message content is untrusted, and that 'pending' means delivery is unconfirmed. These are exactly the behavioral traits an agent needs to call it safely and correctly.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core action, then packs operational facts into short clauses with no filler. The sentences are dense but each carries distinct information; only minor gain from tightening the run-on phrasing.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return values needn't be explained, and the description still covers cost, rate limiting, content trust, and pending semantics. For a read-only list tool with these complexities, nothing essential is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With only 33% schema coverage, the schema leaves inbox_id and capability undocumented, but the description compensates by stating all three parameters come from create_email_inbox. It doesn't add format or validation details, but the provenance guidance covers the main gap for the two required params.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (list received messages in the inbox) and clarifies it includes message IDs and available content. It distinguishes itself from get_email_code by assigning OTP extraction to that sibling, though it doesn't explicitly position against other message-related tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes OTP use to get_email_code, giving a clear when-to-use-this-vs-alternative condition. It also gives operational guidance (poll interval, 429/503 handling), though it doesn't state exclusions or prerequisites such as needing an existing inbox first beyond the create reference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All HirePulse Agent Gateway toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources