Loppee

{
  "name": "Loppee",
  "description": "Loppee's MCP server lets customers find US local businesses, read trust information, message businesses and apply to jobs. Authorized business agents can manage supported business-account actions. This card describes the MCP server. Loppee also runs a separate, read-only A2A v1 service at https://a2a.loppee.com (find and compare businesses, Trust Cards and reviews); it offers no contact, booking, payment or review submission. The A2A interface listed in supportedInterfaces is that read-only service: per its own Agent Card it serves only find_businesses, compare_businesses, get_trust_card and get_business_reviews; every other skill on this card is MCP-only.",
  "version": "0.1.0",
  "url": "https://loppee.com/mcp",
  "provider": {
    "organization": "Loppee Inc",
    "url": "https://loppee.com"
  },
  "documentationUrl": "https://loppee.com/developers",
  "iconUrl": "https://loppee.com/images/loppee-icon-192.png?v=2",
  "supportedInterfaces": [
    {
      "url": "https://a2a.loppee.com/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "a2a": {
    "protocol": "A2A",
    "protocol_version": "1.0",
    "mode": "read_only",
    "origin": "https://a2a.loppee.com",
    "agent_card_url": "https://a2a.loppee.com/.well-known/agent-card.json",
    "json_rpc_endpoint": "https://a2a.loppee.com/a2a",
    "oauth_protected_resource_url": "https://a2a.loppee.com/.well-known/oauth-protected-resource/a2a",
    "skills": [
      "find_businesses",
      "compare_businesses",
      "get_trust_card",
      "get_business_reviews"
    ],
    "access": {
      "anonymous_public_reads": "Business-name lookup, public comparisons, Trust Cards and reviews, plus category/service search near a precise location you provide: coordinates (lat/lng), or a full US street address where address validation is available. A city or state alone is too coarse. No account needed. The provided location is used only for that search's organic reach, is not returned or stored, and is never Sponsored or current-location authority.",
      "oauth": "Optional, for additional scoped access.",
      "read_scope": "loppee:businesses:read"
    },
    "disclosures": "Published businesses retain binary Verified/Listed classes. Preserve original Registry disclosures, Sponsored labels and location redaction. No contact, booking, payment or review submission."
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "securitySchemes": {
    "loppeeApiKey": {
      "apiKeySecurityScheme": {
        "location": "header",
        "name": "X-LOPPEE-API-Key",
        "description": "An existing scoped Loppee agent key. Permissions remain enforced by the server."
      }
    },
    "loppeeOAuth": {
      "oauth2SecurityScheme": {
        "description": "OAuth authorization code with PKCE S256; bearer tokens use the Authorization header. Customer and business connections have separate resource audiences.",
        "oauth2MetadataUrl": "https://loppee.com/oauth/.well-known/oauth-authorization-server",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://loppee.com/oauth/auth",
            "tokenUrl": "https://loppee.com/oauth/token",
            "pkceRequired": true,
            "scopes": {
              "loppee:businesses:read": "Read published business, Trust Card, review, comparison, and recommendation information.",
              "loppee:location:read": "Ask Loppee to use an explicitly approved, short-lived current-location or validated destination handoff for nearby results. The address and raw coordinates are never returned to the assistant.",
              "loppee:messages:read": "Read conversations between your personal account and businesses.",
              "loppee:messages:write": "Send messages from your personal account after you approve the recipient and text.",
              "loppee:reviews:write": "Publish or edit your own agent-assisted review after you approve the business, stars, and text.",
              "loppee:jobs:read": "Read jobs and the applications submitted from your personal account.",
              "loppee:jobs:write": "Apply with your chosen resume or withdraw your own application after you confirm the action.",
              "loppee:business:read": "Read the selected business profile, customer inbox, notifications, reviews, support thread, jobs, and applications.",
              "loppee:business:profile:write": "Update the selected business profile, hours, photos, and deals. Verification, ranking, publishing, and billing authority are excluded.",
              "loppee:business:communications:write": "Reply to customers, contact Loppee support, mark notifications read, and respond to or report reviews for the selected business.",
              "loppee:business:jobs:write": "Create, edit, and delete draft job postings for the selected business, and apply an applicant status already selected by an authorized human owner. Publishing a posting and any payment stay with the owner. The assistant cannot rank applicants or decide for the owner."
            }
          }
        }
      }
    }
  },
  "securityRequirements": [
    {
      "schemes": {
        "loppeeApiKey": {
          "list": []
        }
      }
    },
    {
      "schemes": {
        "loppeeOAuth": {
          "list": [
            "loppee:businesses:read",
            "loppee:location:read"
          ]
        }
      }
    }
  ],
  "x-mcp": {
    "protocol": "mcp",
    "protocolVersion": "2025-11-25",
    "transport": "streamable-http",
    "a2aAgentCardUrl": "https://a2a.loppee.com/.well-known/agent-card.json",
    "capabilitiesUrl": "https://loppee.com/v1/agent-capabilities.json",
    "servers": [
      {
        "name": "customer",
        "url": "https://loppee.com/mcp",
        "securitySchemes": [
          "loppeeApiKey",
          "loppeeOAuth"
        ],
        "resourceMetadataUrl": "https://loppee.com/.well-known/oauth-protected-resource/mcp",
        "scopes": [
          "loppee:businesses:read",
          "loppee:location:read",
          "loppee:messages:read",
          "loppee:messages:write",
          "loppee:reviews:write",
          "loppee:jobs:read",
          "loppee:jobs:write"
        ]
      },
      {
        "name": "business",
        "url": "https://loppee.com/mcp/business",
        "securitySchemes": [
          "loppeeOAuth"
        ],
        "resourceMetadataUrl": "https://loppee.com/.well-known/oauth-protected-resource/mcp/business",
        "scopes": [
          "loppee:business:read",
          "loppee:business:profile:write",
          "loppee:business:communications:write",
          "loppee:business:jobs:write"
        ]
      }
    ]
  },
  "skills": [
    {
      "id": "find-businesses",
      "name": "Find and compare local businesses",
      "description": "Search and compare US local businesses, read Trust Cards and reviews, and preserve each result's Verified, Listed or Registry disclosure.",
      "tags": [
        "search",
        "local",
        "businesses",
        "reviews"
      ],
      "examples": [
        "Find a plumber near me",
        "Compare these two HVAC companies"
      ]
    },
    {
      "id": "contact-and-review",
      "name": "Message, save and review businesses",
      "description": "With the required account permissions, send message requests, read replies, save businesses and submit reviews for moderation.",
      "tags": [
        "messaging",
        "reviews",
        "customer"
      ]
    },
    {
      "id": "jobs",
      "name": "Find and apply to local jobs",
      "description": "Search business job postings and, with account authorization, apply and manage the customer's own applications.",
      "tags": [
        "jobs",
        "applications",
        "customer"
      ]
    },
    {
      "id": "location",
      "name": "Choose a search location",
      "description": "Use supported saved, current or destination location choices through Loppee's consent flow. Raw coordinates are not returned to the agent.",
      "tags": [
        "location",
        "privacy"
      ]
    },
    {
      "id": "manage-business",
      "name": "Manage an authorized business account",
      "description": "Within the connected business's granted permissions, manage profile, hours, photos and deals, reply to messages and reviews, and manage job drafts and owner-selected applicant status. Publishing and payments remain with the human owner.",
      "tags": [
        "owner",
        "profile",
        "messages",
        "jobs"
      ]
    },
    {
      "id": "account-and-support",
      "name": "Account information and support",
      "description": "Read pricing and authorized account information, notifications and support conversations. Scoped API-key agents can inspect their identity and revoke their own key.",
      "tags": [
        "account",
        "support",
        "notifications"
      ]
    }
  ]
}