Skip to main content
Glama
Sign In

Phare

by io.phare.mcp
OverviewDiscussionsAdmin

Create an integration

create_integration

Create an integration of an app for the whole organization, then used by alert rules to deliver their notifications. The apps connected from the dashboard, like Slack, Discord and Telegram, cannot be created this way, and the SMS app requires a Scale plan subscription.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "app": "<app>",
      "name": "<name>"
    },
    "name": "create_integration"
  }
}

Input Schema

NameRequiredDescriptionDefault
appYesThe app key
nameYesIntegration name
settingsNoSettings specific to the integration app

Output Schema

NameRequiredDescriptionDefault
idNoIntegration ID
appNoIntegration app key
nameNoIntegration name
pausedNoIntegration paused status
settingsNoSettings specific to the integration app
created_atNoDate of creation for the entity
updated_atNoDate of last update for the entity

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / settings / anyOf
      Previous value: -[
-  {
-    "maxProperties": 0,
-    "title": "Empty",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "members": {
-        "description": "IDs of the organization members receiving the alerts",
-        "examples": [
-          [
-            1,
-            2
-          ]
-        ],
-        "items": {
-          "type": "integer"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "members"
-    ],
-    "title": "Email",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "integration_key": {
-        "description": "ilert alert source integration key",
-        "examples": [
-          "il1api00000000000000000000000000000000000000"
-        ],
-        "maxLength": 70,
-        "minLength": 40,
-        "type": "string",
-        "writeOnly": true
-      }
-    },
-    "required": [
-      "integration_key"
-    ],
-    "title": "ilert",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "access_token": {
-        "description": "Ntfy access token used for authenticated topics, must start with `tk_`",
-        "examples": [
-          "tk_00000000000000000000000000000"
-        ],
-        "maxLength": 32,
-        "minLength": 32,
-        "type": [
-          "string",
-          "null"
-        ],
-        "writeOnly": true
-      },
-      "hostname": {
-        "description": "Hostname of the Ntfy server",
-        "examples": [
-          "ntfy.sh"
-        ],
-        "maxLength": 100,
-        "minLength": 4,
-        "type": "string"
-      },
-      "topic": {
-        "description": "Ntfy topic receiving the alerts",
-        "examples": [
-          "phare-alerts"
-        ],
-        "maxLength": 255,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "hostname",
-      "topic"
-    ],
-    "title": "Ntfy",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "secret": {
-        "description": "Secret used to sign the webhook requests",
-        "examples": [
-          "a-very-secure-secret"
-        ],
-        "maxLength": 250,
-        "minLength": 10,
-        "type": "string",
-        "writeOnly": true
-      },
-      "url": {
-        "description": "URL receiving the webhook requests",
-        "examples": [
-          "https://example.com/webhooks/phare"
-        ],
-        "format": "uri",
-        "maxLength": 250,
-        "type": "string"
-      }
-    },
-    "required": [
-      "url",
-      "secret"
-    ],
-    "title": "Outgoing Webhooks",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "api_key": {
-        "description": "Pushover application API token",
-        "examples": [
-          "a00000000000000000000000000000"
-        ],
-        "maxLength": 30,
-        "minLength": 30,
-        "type": "string",
-        "writeOnly": true
-      },
-      "user_key": {
-        "description": "Pushover user or group key",
-        "examples": [
-          "u00000000000000000000000000000"
-        ],
-        "maxLength": 30,
-        "minLength": 30,
-        "type": "string",
-        "writeOnly": true
-      }
-    },
-    "required": [
-      "user_key",
-      "api_key"
-    ],
-    "title": "Pushover",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "members": {
-        "description": "IDs of the organization members receiving the alerts",
-        "examples": [
-          [
-            1,
-            2
-          ]
-        ],
-        "items": {
-          "type": "integer"
-        },
-        "maxItems": 100,
-        "minItems": 1,
-        "type": "array"
-      }
-    },
-    "required": [
-      "members"
-    ],
-    "title": "SMS",
-    "type": "object"
-  }
-]New value: +[
+  {
+    "maxProperties": 0,
+    "title": "Empty",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "members": {
+        "description": "IDs of the organization members receiving the alerts",
+        "examples": [
+          [
+            1,
+            2
+          ]
+        ],
+        "items": {
+          "type": "integer"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "members"
+    ],
+    "title": "Email",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "integration_key": {
+        "description": "ilert alert source integration key. It is never returned, an update without it keeps the current key.",
+        "examples": [
+          "il1api00000000000000000000000000000000000000"
+        ],
+        "maxLength": 70,
+        "minLength": 40,
+        "type": "string",
+        "writeOnly": true
+      }
+    },
+    "required": [
+      "integration_key"
+    ],
+    "title": "ilert",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "access_token": {
+        "description": "Ntfy access token used for authenticated topics, must start with `tk_`. It is never returned, an update without it keeps the current token and null removes it.",
+        "examples": [
+          "tk_00000000000000000000000000000"
+        ],
+        "maxLength": 32,
+        "minLength": 32,
+        "type": [
+          "string",
+          "null"
+        ],
+        "writeOnly": true
+      },
+      "hostname": {
+        "description": "Hostname of the Ntfy server",
+        "examples": [
+          "ntfy.sh"
+        ],
+        "maxLength": 100,
+        "minLength": 4,
+        "type": "string"
+      },
+      "topic": {
+        "description": "Ntfy topic receiving the alerts",
+        "examples": [
+          "phare-alerts"
+        ],
+        "maxLength": 255,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "hostname",
+      "topic"
+    ],
+    "title": "Ntfy",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "secret": {
+        "description": "Secret used to sign the webhook requests. It is never returned, an update without it keeps the current secret.",
+        "examples": [
+          "a-very-secure-secret"
+        ],
+        "maxLength": 250,
+        "minLength": 10,
+        "type": "string",
+        "writeOnly": true
+      },
+      "url": {
+        "description": "URL receiving the webhook requests",
+        "examples": [
+          "https://example.com/webhooks/phare"
+        ],
+        "format": "uri",
+        "maxLength": 250,
+        "type": "string"
+      }
+    },
+    "required": [
+      "url",
+      "secret"
+    ],
+    "title": "Outgoing Webhooks",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "api_key": {
+        "description": "Pushover application API token. It is never returned, an update without it keeps the current token.",
+        "examples": [
+          "a00000000000000000000000000000"
+        ],
+        "maxLength": 30,
+        "minLength": 30,
+        "type": "string",
+        "writeOnly": true
+      },
+      "user_key": {
+        "description": "Pushover user or group key. It is never returned, an update without it keeps the current key.",
+        "examples": [
+          "u00000000000000000000000000000"
+        ],
+        "maxLength": 30,
+        "minLength": 30,
+        "type": "string",
+        "writeOnly": true
+      }
+    },
+    "required": [
+      "user_key",
+      "api_key"
+    ],
+    "title": "Pushover",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "members": {
+        "description": "IDs of the organization members receiving the alerts",
+        "examples": [
+          [
+            1,
+            2
+          ]
+        ],
+        "items": {
+          "type": "integer"
+        },
+        "maxItems": 100,
+        "minItems": 1,
+        "type": "array"
+      }
+    },
+    "required": [
+      "members"
+    ],
+    "title": "SMS",
+    "type": "object"
+  }
+]
    • changedOutput schema / properties / settings / anyOf
      Previous value: -[
-  {
-    "title": "Empty",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "members": {
-        "description": "IDs of the organization members receiving the alerts",
-        "examples": [
-          [
-            1,
-            2
-          ]
-        ],
-        "items": {
-          "type": "integer"
-        },
-        "type": "array"
-      }
-    },
-    "title": "Email",
-    "type": "object"
-  },
-  {
-    "properties": {},
-    "title": "ilert",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "hostname": {
-        "description": "Hostname of the Ntfy server",
-        "examples": [
-          "ntfy.sh"
-        ],
-        "type": "string"
-      },
-      "topic": {
-        "description": "Ntfy topic receiving the alerts",
-        "examples": [
-          "phare-alerts"
-        ],
-        "type": "string"
-      }
-    },
-    "title": "Ntfy",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "url": {
-        "description": "URL receiving the webhook requests",
-        "examples": [
-          "https://example.com/webhooks/phare"
-        ],
-        "format": "uri",
-        "type": "string"
-      }
-    },
-    "title": "Outgoing Webhooks",
-    "type": "object"
-  },
-  {
-    "properties": {},
-    "title": "Pushover",
-    "type": "object"
-  },
-  {
-    "properties": {
-      "members": {
-        "description": "IDs of the organization members receiving the alerts",
-        "examples": [
-          [
-            1,
-            2
-          ]
-        ],
-        "items": {
-          "type": "integer"
-        },
-        "type": "array"
-      }
-    },
-    "title": "SMS",
-    "type": "object"
-  }
-]New value: +[
+  {
+    "title": "Empty",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "members": {
+        "description": "IDs of the organization members receiving the alerts",
+        "examples": [
+          [
+            1,
+            2
+          ]
+        ],
+        "items": {
+          "type": "integer"
+        },
+        "type": "array"
+      }
+    },
+    "title": "Email",
+    "type": "object"
+  },
+  {
+    "properties": {},
+    "title": "ilert",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "access_token_enabled": {
+        "description": "Whether an access token is set",
+        "examples": [
+          true
+        ],
+        "readOnly": true,
+        "type": "boolean"
+      },
+      "hostname": {
+        "description": "Hostname of the Ntfy server",
+        "examples": [
+          "ntfy.sh"
+        ],
+        "type": "string"
+      },
+      "topic": {
+        "description": "Ntfy topic receiving the alerts",
+        "examples": [
+          "phare-alerts"
+        ],
+        "type": "string"
+      }
+    },
+    "title": "Ntfy",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "url": {
+        "description": "URL receiving the webhook requests",
+        "examples": [
+          "https://example.com/webhooks/phare"
+        ],
+        "format": "uri",
+        "type": "string"
+      }
+    },
+    "title": "Outgoing Webhooks",
+    "type": "object"
+  },
+  {
+    "properties": {},
+    "title": "Pushover",
+    "type": "object"
+  },
+  {
+    "properties": {
+      "members": {
+        "description": "IDs of the organization members receiving the alerts",
+        "examples": [
+          [
+            1,
+            2
+          ]
+        ],
+        "items": {
+          "type": "integer"
+        },
+        "type": "array"
+      }
+    },
+    "title": "SMS",
+    "type": "object"
+  }
+]
  2. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "properties": {
+    "app": {
+      "description": "Integration app key",
+      "enum": [
+        "sms",
+        "discord",
+        "email",
+        "ilert",
+        "ntfy",
+        "outgoing_webhook",
+        "pushover",
+        "slack",
+        "telegram"
+      ],
+      "type": "string"
+    },
+    "created_at": {
+      "description": "Date of creation for the entity",
+      "format": "date-time",
+      "type": "string"
+    },
+    "id": {
+      "description": "Integration ID",
+      "examples": [
+        1
+      ],
+      "type": "integer"
+    },
+    "name": {
+      "description": "Integration name",
+      "examples": [
+        "DevOps Team"
+      ],
+      "type": "string"
+    },
+    "paused": {
+      "description": "Integration paused status",
+      "examples": [
+        false
+      ],
+      "type": "boolean"
+    },
+    "settings": {
+      "anyOf": [
+        {
+          "title": "Empty",
+          "type": "object"
+        },
+        {
+          "properties": {
+            "members": {
+              "description": "IDs of the organization members receiving the alerts",
+              "examples": [
+                [
+                  1,
+                  2
+                ]
+              ],
+              "items": {
+                "type": "integer"
+              },
+              "type": "array"
+            }
+          },
+          "title": "Email",
+          "type": "object"
+        },
+        {
+          "properties": {},
+          "title": "ilert",
+          "type": "object"
+        },
+        {
+          "properties": {
+            "hostname": {
+              "description": "Hostname of the Ntfy server",
+              "examples": [
+                "ntfy.sh"
+              ],
+              "type": "string"
+            },
+            "topic": {
+              "description": "Ntfy topic receiving the alerts",
+              "examples": [
+                "phare-alerts"
+              ],
+              "type": "string"
+            }
+          },
+          "title": "Ntfy",
+          "type": "object"
+        },
+        {
+          "properties": {
+            "url": {
+              "description": "URL receiving the webhook requests",
+              "examples": [
+                "https://example.com/webhooks/phare"
+              ],
+              "format": "uri",
+              "type": "string"
+            }
+          },
+          "title": "Outgoing Webhooks",
+          "type": "object"
+        },
+        {
+          "properties": {},
+          "title": "Pushover",
+          "type": "object"
+        },
+        {
+          "properties": {
+            "members": {
+              "description": "IDs of the organization members receiving the alerts",
+              "examples": [
+                [
+                  1,
+                  2
+                ]
+              ],
+              "items": {
+                "type": "integer"
+              },
+              "type": "array"
+            }
+          },
+          "title": "SMS",
+          "type": "object"
+        }
+      ],
+      "description": "Settings specific to the integration app"
+    },
+    "updated_at": {
+      "description": "Date of last update for the entity",
+      "format": "date-time",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}
  3. First observed

TDQS

A4.2/5.0
Behavior4/5

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

Annotations already declare this is a non-read-only, non-destructive, non-idempotent, open-world operation, so the description is not carrying the safety profile alone. It adds genuinely non-obvious context: the integration is organization-wide and feeds alert rules, and creation is gated by app type and by the Scale plan subscription. It stops short of saying what happens if an integration for the same app already exists.

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

Conciseness5/5

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

Two sentences with no filler, front-loaded with the create action and scope, then the eligibility constraints. Every clause adds a decision-relevant fact.

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 need no explanation, and the schema fully documents the per-app settings. Combined with annotations and the eligibility rules, an agent has everything needed to decide whether to call this tool and how to populate it.

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?

Schema description coverage is 100%, so the schema documents 'app', 'name' and each per-app 'settings' variant in detail. The description still adds meaning beyond the schema by explaining why the app enum is limited to sms, email, ilert, ntfy, outgoing_webhook and pushover and by flagging the subscription constraint that applies to one enum value.

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 ('Create an integration of an app') plus the scope ('for the whole organization') and downstream purpose ('used by alert rules to deliver their notifications'). The create/read/update/delete family is distinguishable by the verb, though it never names update_integration or get_integration as the alternatives.

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?

Gives concrete negative guidance — dashboard-connected apps like Slack, Discord and Telegram cannot be created this way — and a prerequisite for the SMS app ('requires a Scale plan subscription'). It does not route to a sibling tool for the excluded app types, but the when-not-to-use conditions are explicit.

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

All Phare toolsInspect
Try in Browser
Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources