pylon_create_contact · Pylon MCP: Risk & Policy

WHAT IT DOES

What pylon_create_contact does on Pylon

AI agents use pylon_create_contact to create or update resources in Pylon — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Pylon environment.

WHY IT NEEDS A POLICY

Why pylon_create_contact needs a policy

This tool creates a new contact record in the Pylon system, which is a write operation that modifies the customer database. While reversible (contacts can typically be deleted or updated), it adds new data to the system and could have moderate business impact if misused (e.g., creating duplicate or fraudulent contacts, polluting the database).

From the tool's definition Tool name 'pylon_create_contact' and description 'Create a new customer contact in Pylon' indicate data creation. The phrase 'Use carefully' suggests the action has reversible but notable consequences.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

pylon_create_contact Rate-limited

pylon_create_contact stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "pylon_create_contact": {
      "limits": [
        {
          "counter": "pylon_create_contact_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL →

Instant setup, no code required.

PolicyLayer is an MCP gateway: every tool call is checked against your rule before it reaches Pylon, so you can run agents against it safely.

FAQ

Questions about pylon_create_contact

What does the pylon_create_contact tool do? +

Create a new customer contact in Pylon. Use carefully. It is categorised as a Write tool in the Pylon MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on pylon_create_contact? +

Register the Pylon MCP server in PolicyLayer and add a rule for pylon_create_contact: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Pylon. Nothing to install.

What risk level is pylon_create_contact? +

pylon_create_contact is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit pylon_create_contact? +

Yes. Add a rate_limit block to the pylon_create_contact rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block pylon_create_contact completely? +

Set action: deny in the PolicyLayer policy for pylon_create_contact. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides pylon_create_contact? +

pylon_create_contact is provided by the Pylon MCP server (@customer-support-success/pylon-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.