email

Get account

getAccount

Read-onlyIdempotent

The authenticated Primitive account. managed_inbox_address is a domain, not a mailbox; sender_address (such as agent@pink-ram.primitive.email) is the mailbox sendEmail sends from by default. Result: id, email, plan, managed_inbox_address, created_at, limits, entitlements, onboarding_completed, and sender_address when there is a managed inbox.

Input Schema

Name	Required	Description	Default
`api_key`	No	API key from createEmailAddress, used in place of sign-in.

Output Schema

Name	Required	Description
`id`	Yes	Account id.
`plan`	Yes	Plan name, such as agent or developer.
`email`	Yes	Owner email; null for a no-signup account, or for a caller that cannot read member emails.
`limits`	Yes	What the plan allows.
`created_at`	Yes	When the account was made.
`entitlements`	Yes	Granted capabilities, such as send_mail.
`sender_address`	No	Mailbox to send from by default. Set when there is a managed inbox.
`onboarding_completed`	Yes	True when setup is finished; null if unknown.
`managed_inbox_address`	Yes	Managed inbox domain, not a mailbox; null if none.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedNov 3, 2026

changedOutput schema / properties / email / description

Previous value: -"Owner email; null for a no-signup account."New value: +"Owner email; null for a no-signup account, or for a caller that cannot read member emails."

Changed1 schema field changedNov 2, 2026

changedOutput schema / properties / email / description

Previous value: -"Owner email; null for a no-signup account, or for a caller that cannot read member emails."New value: +"Owner email; null for a no-signup account."

Changed1 schema field changedNov 2, 2026

changedOutput schema / properties / email / description

Previous value: -"Owner email; null for a no-signup account."New value: +"Owner email; null for a no-signup account, or for a caller that cannot read member emails."

Changed15 schema fields changedOct 22, 2026

addedOutput schema / additionalProperties
```
Added value: +false
```

changedOutput schema / description

Previous value: -"Envelope; the result is in data.data."New value: +"The account: plan, limits and the mailbox to send from."

addedOutput schema / properties / created_at

Added value: +{
+  "description": "When the account was made.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

removedOutput schema / properties / data

Removed value: -{
-  "description": "API response: the result in data, or error.",
-  "properties": {
-    "data": {
-      "description": "The account: plan, limits, managed inbox.",
-      "properties": {
-        "email": {
-          "description": "Owner email; null for a no-signup account.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "entitlements": {
-          "description": "Granted capabilities, such as send_mail.",
-          "type": "array"
-        },
-        "id": {
-          "description": "Account id.",
-          "type": "string"
-        },
-        "limits": {
-          "description": "What the plan allows.",
-          "properties": {
-            "api_per_minute": {
-              "type": [
-                "number",
-                "string"
-              ]
-            },
-            "send_per_day": {
-              "type": [
-                "number",
-                "string"
-              ]
-            },
-            "send_per_hour": {
-              "type": [
-                "number",
-                "string"
-              ]
-            },
-            "storage_mb": {
-              "type": [
-                "number",
-                "string"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "managed_inbox_address": {
-          "description": "Managed inbox domain, not a mailbox.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "onboarding_completed": {
-          "description": "Setup finished.",
-          "type": [
-            "boolean",
-            "null"
-          ]
-        },
-        "plan": {
-          "description": "Plan name.",
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "sender_address": {
-          "description": "Default sender mailbox.",
-          "type": "string"
-        }
-      },
-      "type": [
-        "object",
-        "null"
-      ]
-    },
-    "error": {
-      "description": "Why the call was refused; absent on success.",
-      "properties": {
-        "code": {
-          "description": "Error code to branch on.",
-          "type": "string"
-        },
-        "message": {
-          "description": "What went wrong, in words.",
-          "type": "string"
-        }
-      },
-      "type": [
-        "object",
-        "null"
-      ]
-    },
-    "success": {
-      "description": "True when data holds the result.",
-      "type": "boolean"
-    }
-  },
-  "type": "object"
-}

addedOutput schema / properties / email

Added value: +{
+  "description": "Owner email; null for a no-signup account.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / entitlements

Added value: +{
+  "description": "Granted capabilities, such as send_mail.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / id

Added value: +{
+  "description": "Account id.",
+  "type": "string"
+}

addedOutput schema / properties / limits

Added value: +{
+  "additionalProperties": false,
+  "description": "What the plan allows.",
+  "properties": {
+    "api_per_minute": {
+      "description": "API requests per minute.",
+      "type": "integer"
+    },
+    "send_per_day": {
+      "description": "Emails it may send per day.",
+      "type": "integer"
+    },
+    "send_per_hour": {
+      "description": "Emails it may send per hour.",
+      "type": "integer"
+    },
+    "storage_mb": {
+      "description": "Mail storage, in MB.",
+      "type": "number"
+    }
+  },
+  "required": [
+    "send_per_hour",
+    "send_per_day",
+    "api_per_minute",
+    "storage_mb"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / managed_inbox_address

Added value: +{
+  "description": "Managed inbox domain, not a mailbox; null if none.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / onboarding_completed

Added value: +{
+  "description": "True when setup is finished; null if unknown.",
+  "type": [
+    "boolean",
+    "null"
+  ]
+}

addedOutput schema / properties / plan

Added value: +{
+  "description": "Plan name, such as agent or developer.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / properties / sender_address

Added value: +{
+  "description": "Mailbox to send from by default. Set when there is a managed inbox.",
+  "type": "string"
+}

removedOutput schema / properties / status

Removed value: -{
-  "description": "HTTP status; 2xx on success.",
-  "type": "number"
-}

removedOutput schema / properties / tool

Removed value: -{
-  "description": "Tool that answered.",
-  "type": "string"
-}

changedOutput schema / required

Previous value: -[
-  "tool",
-  "status",
-  "data"
-]New value: +[
+  "id",
+  "email",
+  "plan",
+  "managed_inbox_address",
+  "created_at",
+  "limits",
+  "entitlements",
+  "onboarding_completed"
+]

Changed9 schema fields changedOct 22, 2026

changedInput schema / properties / api_key / description

Previous value: -"Your API key from createEmailAddress, used in place of sign-in."New value: +"API key from createEmailAddress, used in place of sign-in."

changedOutput schema / properties / data / description

Previous value: -"API response; result in data."New value: +"API response: the result in data, or error."

changedOutput schema / properties / data / properties / error / description

Previous value: -"Refusal: code, message."New value: +"Why the call was refused; absent on success."

addedOutput schema / properties / data / properties / error / properties

Added value: +{
+  "code": {
+    "description": "Error code to branch on.",
+    "type": "string"
+  },
+  "message": {
+    "description": "What went wrong, in words.",
+    "type": "string"
+  }
+}

addedOutput schema / properties / data / properties / error / type
```
Added value: +[
+  "object",
+  "null"
+]
```

changedOutput schema / properties / data / properties / success / description

Previous value: -"Accepted."New value: +"True when data holds the result."

changedOutput schema / properties / data / type

Previous value: -[
-  "object",
-  "string",
-  "null"
-]New value: +"object"

changedOutput schema / properties / status / description

Previous value: -"HTTP status."New value: +"HTTP status; 2xx on success."

addedOutput schema / properties / tool / description
```
Added value: +"Tool that answered."
```

Changed4 schema fields changedOct 21, 2026

changedOutput schema / description

Previous value: -"The account: plan, limits, managed inbox."New value: +"Envelope; the result is in data.data."

changedOutput schema / properties / data / description

Previous value: -"API body."New value: +"API response; result in data."

addedOutput schema / properties / data / properties / data / description
```
Added value: +"The account: plan, limits, managed inbox."
```
changedOutput schema / properties / data / properties / error / description
```
Previous value: -"Why refused."New value: +"Refusal: code, message."
```

Changed3 schema fields changedOct 20, 2026

changedInput schema / properties / api_key / description

Previous value: -"Key createEmailAddress returned. Send it when no account is signed in."New value: +"Your API key from createEmailAddress, used in place of sign-in."

changedOutput schema / properties / data / properties / data / properties / limits / description

Previous value: -"Caps: send_per_hour, send_per_day, api_per_minute."New value: +"What the plan allows."

addedOutput schema / properties / data / properties / data / properties / limits / properties

Added value: +{
+  "api_per_minute": {
+    "type": [
+      "number",
+      "string"
+    ]
+  },
+  "send_per_day": {
+    "type": [
+      "number",
+      "string"
+    ]
+  },
+  "send_per_hour": {
+    "type": [
+      "number",
+      "string"
+    ]
+  },
+  "storage_mb": {
+    "type": [
+      "number",
+      "string"
+    ]
+  }
+}

Changed6 schema fields changedOct 20, 2026
- changedInput schema / properties / api_key / description
```
Previous value: -"The api_key from createEmailAddress, for a connection with no signed-in account. Leave it out when signed in."New value: +"Key createEmailAddress returned. Send it when no account is signed in."
```
- addedOutput schema / properties / data / properties / data / properties / email / description
```
Added value: +"Owner email; null for a no-signup account."
```
- changedOutput schema / properties / data / properties / data / properties / entitlements / description
```
Previous value: -"Granted capabilities."New value: +"Granted capabilities, such as send_mail."
```
- addedOutput schema / properties / data / properties / data / properties / id / description
```
Added value: +"Account id."
```
- addedOutput schema / properties / data / properties / data / properties / limits / description
```
Added value: +"Caps: send_per_hour, send_per_day, api_per_minute."
```
- addedOutput schema / properties / data / properties / data / properties / plan / description
```
Added value: +"Plan name."
```

Changed8 schema fields changedOct 20, 2026

changedInput schema / properties / api_key / description

Previous value: -"Only when no account is signed in: the api_key createEmailAddress returned, passed as is on every later call. Omit it when the user is signed in."New value: +"The api_key from createEmailAddress, for a connection with no signed-in account. Leave it out when signed in."

addedOutput schema / description

Added value: +"The account: plan, limits, managed inbox."

addedOutput schema / properties / data / description
```
Added value: +"API body."
```
addedOutput schema / properties / data / properties / data / properties / onboarding_completed / description
```
Added value: +"Setup finished."
```

changedOutput schema / properties / data / properties / data / properties / sender_address / description

Previous value: -"Mailbox sendEmail uses when from is left out."New value: +"Default sender mailbox."

addedOutput schema / properties / data / properties / error / description
```
Added value: +"Why refused."
```
addedOutput schema / properties / data / properties / success / description
```
Added value: +"Accepted."
```
addedOutput schema / properties / status / description
```
Added value: +"HTTP status."
```

Changed4 schema fields changedOct 20, 2026

changedInput schema / properties / api_key / description

Previous value: -"Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omit it when the user is signed in."New value: +"Only when no account is signed in: the api_key createEmailAddress returned, passed as is on every later call. Omit it when the user is signed in."

addedOutput schema / properties / data / properties / data / properties / entitlements / description
```
Added value: +"Granted capabilities."
```
addedOutput schema / properties / data / properties / data / properties / managed_inbox_address / description
```
Added value: +"Managed inbox domain, not a mailbox."
```
addedOutput schema / properties / data / properties / data / properties / sender_address / description
```
Added value: +"Mailbox sendEmail uses when from is left out."
```

Changed4 schema fields changedOct 18, 2026

removedOutput schema / additionalProperties
```
Removed value: -false
```

addedOutput schema / properties / data / properties

Added value: +{
+  "data": {
+    "properties": {
+      "email": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "entitlements": {
+        "type": "array"
+      },
+      "id": {
+        "type": "string"
+      },
+      "limits": {
+        "type": "object"
+      },
+      "managed_inbox_address": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "onboarding_completed": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "plan": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "sender_address": {
+        "type": "string"
+      }
+    },
+    "type": [
+      "object",
+      "null"
+    ]
+  },
+  "error": {},
+  "success": {
+    "type": "boolean"
+  }
+}

addedOutput schema / properties / data / type

Added value: +[
+  "object",
+  "string",
+  "null"
+]

removedOutput schema / properties / statusText
```
Removed value: -{
-  "type": "string"
-}
```

Changed1 schema field changedAug 13, 2026

addedInput schema / properties / api_key

Added value: +{
+  "description": "Primitive API key (prim_...). Only needed when this connection has no signed-in account: pass the api_key returned by createEmailAddress, unchanged, on every call for the rest of the conversation. Omit it when the user is signed in.",
+  "maxLength": 200,
+  "minLength": 8,
+  "type": "string"
+}

First observedJun 9, 2026

TDQS

A3.5/5.0

Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description earns credit beyond that by disclosing a genuine semantic trap — managed_inbox_address is a domain, not a mailbox — and by naming which address sendEmail sends from by default, which prevents a costly misuse. It does not cover auth failure behavior or whether fields can be absent.

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?

Two dense sentences with no filler, and the domain-vs-mailbox correction is front-loaded before the result list. The opening sentence is a bare fragment rather than a statement of action, which slightly weakens the front-loading.

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

Completeness4/5

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

A no-required-parameter, read-only, single-object fetch with a full output schema is a low-complexity case, and the description covers the one non-obvious semantic hazard. Enumerating the returned fields duplicates the output schema, so that sentence is reassurance rather than necessary information.

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

Parameters3/5

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

There is one parameter (api_key) and schema description coverage is 100%, with the schema already explaining it comes from createEmailAddress and substitutes for sign-in. The description does not mention api_key at all, so it adds nothing here, but with full coverage the baseline of 3 applies.

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?

"The authenticated Primitive account" names the exact resource being fetched, and the enumerated result fields (id, email, plan, limits, entitlements, sender_address) make the scope concrete. It lacks a verb and any explicit statement of what makes it distinct from the email-oriented siblings, but no sibling could plausibly be confused with it.

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

Usage Guidelines2/5

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

The description never says when to call this tool, whether it requires authentication first, or what to do instead if only a specific mailbox is needed. The only directional hint is that sender_address is what sendEmail uses by default, which is field semantics rather than when-to-use guidance.

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

All email tools Inspect

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

Need Help?