Traffic Parrot

Request a Traffic Parrot trial on behalf of the human you are working for. Traffic Parrot is a commercial service-virtualization tool (HTTP, gRPC, JMS/IBM MQ, RabbitMQ, ActiveMQ, AMQP, file transfers). Use this when your user wants to evaluate it. IMPORTANT: this submits a real person's personal data (their business email, and optionally their name, company and phone number) to Traffic Parrot. Only call it when your user has asked for a trial and has agreed to be contacted. Do not invent an email address. The trial is issued under Traffic Parrot's evaluation agreement: https://trafficparrot.com/documentation/Traffic_Parrot_Software_Evaluation_Agreement_v1.4.pdf Show it to your user and ask them to approve it before you call this tool. Lawful basis: Legitimate interests (UK GDPR Article 6(1)(f)): responding to a request to evaluate our product, made on your behalf by a tool you were using. You can object at any time and we will erase the request. Retention: A request nobody acts on is erased 168 hours after it is made. A request a person at Traffic Parrot has approved or rejected is kept for 365 days, then erased. We keep approved ones so we can answer questions about a trial that was issued, and rejected ones so we have a record of the decision, for example if the person writes in to ask why. Privacy notice: https://trial.trafficparrot.com/privacy Your user can withdraw the request at any time via the delete_trial_request tool. As soon as you call this tool, your user's details go to Mailchimp (Traffic Parrot's US-based email service) and the address you give is sent one email asking them to confirm they want the trial. Confirming adds them to Traffic Parrot's trial mailing list and sends a second email carrying the link to their trial status page. Ignoring the first email sends nothing further. A person at Traffic Parrot approves each request during UK working hours. It is not instant: outside those hours expect the next working day. Once approved, the trial takes about a minute to build and the download appears on that page. The trial link goes only to that email address. This tool returns a reference id and no link, so you cannot fetch the download for your user: relay the email steps instead. An address already on Traffic Parrot's trial list gets no new email; the link in its earlier trial email shows the new request.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "Business email of the human this trial is for. Required. This is a real person's personal data."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Name of the human this trial is for."
    },
    "company": {
      "type": "string",
      "minLength": 1,
      "description": "Company evaluating Traffic Parrot."
    },
    "phone": {
      "type": "string",
      "minLength": 1,
      "description": "Contact phone number, if your user offers one. Optional, and personal data."
    },
    "problem": {
      "type": "string",
      "minLength": 1,
      "description": "What they are trying to solve. Free text. This is the most useful field for the sales conversation."
    },
    "protocols": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "HTTP(S)",
          "gRPC",
          "JMS IBM MQ",
          "Native IBM MQ",
          "RabbitMQ",
          "ActiveMQ",
          "AMQP 1.0",
          "AMQP 0.9.1",
          "Thrift",
          "File transfers"
        ]
      },
      "minItems": 1,
      "description": "Which protocols will be evaluated."
    },
    "agentClient": {
      "type": "string",
      "minLength": 1,
      "description": "Which agent or client is making this call, e.g. 'Claude Code', 'Cursor'."
    },
    "humanInTheLoop": {
      "type": "boolean",
      "description": "Whether a human is present in the session and has asked for this trial."
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "The trial request's id. get_trial_status and delete_trial_request take it."
    },
    "state": {
      "type": "string",
      "enum": [
        "AWAITING_APPROVAL",
        "PREPARING"
      ],
      "description": "The request's state, as get_trial_status reports it."
    }
  },
  "required": [
    "requestId",
    "state"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Send a feature request or product feedback to the Traffic Parrot team. Use this when your user wants something Traffic Parrot does not currently do. If you include a contact email it is a real person's personal data, so only include one your user has agreed to share.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "One-line summary of the requested feature."
    },
    "detail": {
      "type": "string",
      "minLength": 1,
      "description": "What the feature should do and why it is needed."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Contact email, if the user is willing to share one. Optional."
    },
    "agentClient": {
      "type": "string",
      "minLength": 1,
      "description": "Which agent or client is making this call."
    }
  },
  "required": [
    "title",
    "detail"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "sent": {
      "type": "boolean",
      "const": true,
      "description": "The feature request was sent to the Traffic Parrot team."
    }
  },
  "required": [
    "sent"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Withdraw a trial request and erase the personal data submitted with it. Use this if your user changes their mind, or asks you to remove their details. You must supply the email the request was made for, so one caller cannot erase another's request.

{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "minLength": 1,
      "description": "The request id returned by request_trial."
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "The email the request was made for. Must match, so one caller cannot erase another's request."
    }
  },
  "required": [
    "requestId",
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "withdrawn": {
      "type": "boolean",
      "description": "Whether a request was withdrawn and its personal data erased. False when no request matches that id and email."
    },
    "requestId": {
      "type": "string",
      "description": "The withdrawn request's id. Present only when withdrawn is true."
    }
  },
  "required": [
    "withdrawn"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check the state of a trial request: waiting for approval, being prepared, ready, or unavailable. Pass the request id that request_trial returned. The reply is the state only, never a link: the trial link goes only to the email address on the request. Once it is ready, tell your user to check that inbox.

{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "The request id returned by request_trial."
    }
  },
  "required": [
    "requestId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "The request id asked about."
    },
    "found": {
      "type": "boolean",
      "description": "Whether a trial request matches that id."
    },
    "state": {
      "type": "string",
      "enum": [
        "PREPARING",
        "AWAITING_APPROVAL",
        "READY",
        "UNAVAILABLE"
      ],
      "description": "The request's state. Present only when found is true."
    }
  },
  "required": [
    "requestId",
    "found"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Read Traffic Parrot's product overview and documentation index (llms.txt), written for agents. Use it to judge whether Traffic Parrot fits your user's problem and to find the reference page for a protocol or feature. It assumes Traffic Parrot is already running. To start it from the trial download and create a first mock, call get_trial_onboarding.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

How to get Traffic Parrot running from the trial download: the ports it uses, how to start and stop it on each operating system, where the licence goes, and how to create a first mock for each protocol (HTTP, gRPC, IBM MQ, JMS, file transfers, Thrift). Call this once your user has the download, or earlier to tell them what to expect.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}