Server definition

Hash: sha256:f914521b36c287d68bc01de7f275ebafd26a253a864d086f79d97b10a1f6fcb9
What it is: What a remote MCP server returned when asked what it offers: 15 tools

The blob, as servednamed by its sha256

{
  "instructions": null,
  "tools": [
    {
      "description": "Run a funnel over a time window and return per-step visitor count, conversion from previous step, conversion from start, and average time to convert between steps. Returns `truncated` flags if the scan cap was hit.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "funnelId": {
            "type": "string"
          },
          "since": {
            "description": "Start of window as unix milliseconds. Defaults to 7 days ago.",
            "type": "number"
          },
          "until": {
            "description": "End of window as unix milliseconds. Defaults to now.",
            "type": "number"
          }
        },
        "required": [
          "funnelId"
        ],
        "type": "object"
      },
      "name": "compute_funnel",
      "outputSchema": null
    },
    {
      "description": "Create a new funnel on a project. Steps are 2–10 ordered events or pageview paths. conversionWindowMs caps how long a visitor has between consecutive steps (default 7 days); this is the step-to-step limit, without which a funnel is just event co-occurrence. Returns { id } on success.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "conversionWindowMs": {
            "description": "Max ms between consecutive steps. Default 7 days (604800000). Bounds: 60000 (1 min) to 7776000000 (90 days).",
            "type": "number"
          },
          "description": {
            "description": "Optional longer description.",
            "type": "string"
          },
          "name": {
            "description": "Human-readable name.",
            "type": "string"
          },
          "project": {
            "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects.",
            "type": "string"
          },
          "steps": {
            "description": "Ordered list of 2–10 steps. Visitors must hit them in order.",
            "items": {
              "additionalProperties": false,
              "properties": {
                "kind": {
                  "description": "'event' for a custom analytics.track() event, 'pageview' for a page-path match.",
                  "enum": [
                    "event",
                    "pageview"
                  ],
                  "type": "string"
                },
                "label": {
                  "description": "Optional friendly display name.",
                  "type": "string"
                },
                "match": {
                  "description": "Event name (for kind='event') or exact pageview path (for kind='pageview').",
                  "type": "string"
                }
              },
              "required": [
                "kind",
                "match"
              ],
              "type": "object"
            },
            "maxItems": 10,
            "minItems": 2,
            "type": "array"
          }
        },
        "required": [
          "project",
          "name",
          "steps"
        ],
        "type": "object"
      },
      "name": "create_funnel",
      "outputSchema": null
    },
    {
      "description": "Soft delete a funnel. The row is retained with status='deleted' and excluded from list/get/compute. Idempotent — calling twice is a no-op. Use if the funnel is obsolete; the record is kept for audit and cannot be undone from MCP.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "funnelId": {
            "type": "string"
          }
        },
        "required": [
          "funnelId"
        ],
        "type": "object"
      },
      "name": "delete_funnel",
      "outputSchema": null
    },
    {
      "description": "Count CUSTOM PRODUCT events for a specific project in a time window, optionally filtered to one event name and/or one user. Custom events are emitted by explicit analytics.track() calls in app code (signup_completed, payment_succeeded, etc.). This does NOT count page views — use pageviews_count or weekly_digest for those. Returns count, unique visitors, and a `truncated` flag if the scan hit the maximum scan size.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "name": {
            "description": "Optional event name to filter by (e.g. 'signup_completed'). If omitted, counts all custom events in the window. Do NOT pass 'page_view' here — page views are in a separate table.",
            "type": "string"
          },
          "project": {
            "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects.",
            "type": "string"
          },
          "since": {
            "description": "Start of window as unix milliseconds. Defaults to 7 days ago.",
            "type": "number"
          },
          "until": {
            "description": "End of window as unix milliseconds. Defaults to now.",
            "type": "number"
          },
          "user": {
            "description": "Optional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity.",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "events_count",
      "outputSchema": null
    },
    {
      "description": "Return the full definition of one funnel by id: name, description, ordered steps, and conversion window.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "funnelId": {
            "description": "Funnel id from list_funnels or create_funnel.",
            "type": "string"
          }
        },
        "required": [
          "funnelId"
        ],
        "type": "object"
      },
      "name": "get_funnel",
      "outputSchema": null
    },
    {
      "description": "Return the current month's custom-event usage, monthly quota, retention days, and plan name for the team.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "get_usage",
      "outputSchema": null
    },
    {
      "description": "List active funnels defined on a project. A funnel is a saved ordered sequence of steps (events or pageview paths) that Convalytics computes step-by-step conversion for. Soft-deleted funnels are excluded.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project": {
            "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects.",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "list_funnels",
      "outputSchema": null
    },
    {
      "description": "List all Convalytics projects on the team this token belongs to. Useful when the agent needs to confirm the project it's querying against. No arguments.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "name": "list_projects",
      "outputSchema": null
    },
    {
      "description": "Count page views for a specific project in a time window. Page views are the automatic hits captured by the browser script tag (separate from custom events). Use this for web-traffic questions like 'how many pageviews in the last 24 hours'. Default window is the last 7 days. Pass `user` to scope to one visitor.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project": {
            "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects.",
            "type": "string"
          },
          "since": {
            "description": "Start of window as unix milliseconds. Defaults to 7 days ago.",
            "type": "number"
          },
          "until": {
            "description": "End of window as unix milliseconds. Defaults to now.",
            "type": "number"
          },
          "user": {
            "description": "Optional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity.",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "pageviews_count",
      "outputSchema": null
    },
    {
      "description": "Return the most recent custom events for a specific project, optionally filtered to one event name and/or one user. PII (userEmail, userName, props) is redacted by default; pass redact: false to include them.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "description": "Maximum number of events to return. Default 20, max 100.",
            "type": "number"
          },
          "name": {
            "description": "Optional event name to filter by (e.g. 'signup_completed'). Omit to return events of any name.",
            "type": "string"
          },
          "project": {
            "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects.",
            "type": "string"
          },
          "redact": {
            "description": "If true (default), userEmail/userName are null and props is {}. Set to false to include them.",
            "type": "boolean"
          },
          "user": {
            "description": "Optional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity.",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "recent_events",
      "outputSchema": null
    },
    {
      "description": "Return the top pages for a specific project, ranked by views in a time window. Default window is the last 7 days. Use list_projects first if you don't know the project name. Returns path, views, uniqueVisitors, and percentage of total views for each page. Pass `user` to see pages a specific visitor hit.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "description": "Maximum number of pages to return. Default 20, max 50.",
            "type": "number"
          },
          "project": {
            "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects.",
            "type": "string"
          },
          "since": {
            "description": "Start of window as unix milliseconds. Defaults to 7 days ago.",
            "type": "number"
          },
          "until": {
            "description": "End of window as unix milliseconds. Defaults to now.",
            "type": "number"
          },
          "user": {
            "description": "Optional. Filter to one visitor/user. Accepts userEmail (case-insensitive) or visitorId (exact). For the full per-user snapshot prefer user_activity.",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "top_pages",
      "outputSchema": null
    },
    {
      "description": "Return the top referring hosts for a specific project, ranked by visit count in a time window. Includes '(direct)' for visits with no referrer. Default window is the last 7 days.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "limit": {
            "description": "Maximum number of referrers to return. Default 10, max 50.",
            "type": "number"
          },
          "project": {
            "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects.",
            "type": "string"
          },
          "since": {
            "description": "Start of window as unix milliseconds. Defaults to 7 days ago.",
            "type": "number"
          },
          "until": {
            "description": "End of window as unix milliseconds. Defaults to now.",
            "type": "number"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "top_referrers",
      "outputSchema": null
    },
    {
      "description": "Patch an existing funnel. Any subset of name/description/steps/conversionWindowMs. Refuses updates on deleted funnels.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "conversionWindowMs": {
            "type": "number"
          },
          "description": {
            "type": "string"
          },
          "funnelId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "steps": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "kind": {
                  "description": "'event' for a custom analytics.track() event, 'pageview' for a page-path match.",
                  "enum": [
                    "event",
                    "pageview"
                  ],
                  "type": "string"
                },
                "label": {
                  "description": "Optional friendly display name.",
                  "type": "string"
                },
                "match": {
                  "description": "Event name (for kind='event') or exact pageview path (for kind='pageview').",
                  "type": "string"
                }
              },
              "required": [
                "kind",
                "match"
              ],
              "type": "object"
            },
            "maxItems": 10,
            "minItems": 2,
            "type": "array"
          }
        },
        "required": [
          "funnelId"
        ],
        "type": "object"
      },
      "name": "update_funnel",
      "outputSchema": null
    },
    {
      "description": "Composite snapshot of a specific user's activity on a project. Returns an identity block (visitorId, userEmail, userName, firstSeen, lastSeen), total pageviews, total custom events, session count, top pages this user visited, their most-fired event names, and their 20 most recent events with props. Use this for 'how is [email protected] using my app?' style questions — one call, full picture. For ad-hoc drill-down (just a count, just recent events) pass `user` to the individual tools instead. Default window is the last 7 days.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "project": {
            "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects.",
            "type": "string"
          },
          "since": {
            "description": "Start of window as unix milliseconds. Defaults to 7 days ago.",
            "type": "number"
          },
          "until": {
            "description": "End of window as unix milliseconds. Defaults to now.",
            "type": "number"
          },
          "user": {
            "description": "User identifier. Accepts userEmail (case-insensitive, e.g. '[email protected]') or visitorId (the exact string passed as userId on the original track() call).",
            "type": "string"
          }
        },
        "required": [
          "project",
          "user"
        ],
        "type": "object"
      },
      "name": "user_activity",
      "outputSchema": null
    },
    {
      "description": "Composite snapshot of a project's web analytics over a lookback window. Returns unique visitors, pageviews, sessions, bounce rate, average session duration, top 5 pages, top 5 referrers, total custom events, and top 5 event names. Includes period-over-period comparison against the prior equal-length window unless compare: false. Prefer this over chaining top_pages + top_referrers + events_count when the agent just wants to report on the week.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "compare": {
            "description": "Include period-over-period comparison against the prior equal-length window. Default true. Set false for faster response when only current numbers matter.",
            "type": "boolean"
          },
          "days": {
            "description": "Lookback window in days, 1 to 90. Default 7.",
            "type": "number"
          },
          "project": {
            "description": "Project name (case-insensitive, e.g. 'slopbench') or project id from list_projects.",
            "type": "string"
          }
        },
        "required": [
          "project"
        ],
        "type": "object"
      },
      "name": "weekly_digest",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:f914521b36c287d68bc01de7f275ebafd26a253a864d086f79d97b10a1f6fcb9 | sha256sum