Support Local Businesses

{
  "protocolVersion": "1.0",
  "name": "Support Local Businesses",
  "description": "The most complete US local business and Florida commercial data platform for AI agents. 6.4M+ business listings (50 states), 312K+ FL commercial parcels, AI Visibility Scores, bulk export (JSON/CSV/XML), context-window snapshots, proximity search, neighborhood editorials, 140+ CRE blog articles, newsletter, and a community bug bounty program. 23 MCP tools. x402 micropayments live \u2014 100 free queries/day, then $0.001 USDC on Base.",
  "url": "https://support-local-businesses.com",
  "version": "1.0.0",
  "documentationUrl": "https://support-local-businesses.com/docs/api",
  "provider": {
    "organization": "OctaPrime",
    "url": "https://support-local-businesses.com",
    "email": "support-local-businesses@polsia.app"
  },
  "supportedInterfaces": [
    {
      "url": "https://support-local-businesses.com/api/v1",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0"
    },
    {
      "url": "https://support-local-businesses.com/api/mcp/content",
      "protocolBinding": "MCP",
      "protocolVersion": "2024-11-05",
      "description": "JSON-RPC 2.0 \u2014 tools: get_business_info, list_datasets, query_dataset"
    },
    {
      "url": "https://support-local-businesses.com/api/mcp/search",
      "protocolBinding": "MCP",
      "protocolVersion": "2024-11-05",
      "description": "JSON-RPC 2.0 \u2014 tools: search_businesses (fuzzy), search_nearby (proximity)"
    }
  ],
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "securitySchemes": {
    "x402": {
      "type": "x402",
      "description": "First 100 queries/day free per API key or IP. After free tier: $0.001 USDC per request on Base mainnet via x402 protocol. No subscription required.",
      "x-x402-network": "eip155:8453",
      "x-x402-network-name": "Base",
      "x-x402-currency": "USDC",
      "x-x402-currency-contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "x-x402-wallet": "0x0cF67aB1D0C843F67bC64D507A5627a41AE5BBC0",
      "x-x402-discovery": "https://support-local-businesses.polsia.app/.well-known/pay"
    }
  },
  "security": [
    {
      "x402": []
    }
  ],
  "authentication": {
    "schemes": [
      "x402"
    ],
    "x402": {
      "description": "First 100 queries/day free per API key or IP. After free tier: $0.001 USDC per request on Base mainnet via x402 protocol. No subscription required.",
      "network": "eip155:8453",
      "network_name": "Base",
      "currency": "USDC",
      "currency_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "wallet": "0x0cF67aB1D0C843F67bC64D507A5627a41AE5BBC0",
      "free_tier": {
        "limit": 100,
        "window": "day",
        "per": "api_key_or_ip"
      },
      "discovery": "https://support-local-businesses.polsia.app/.well-known/pay"
    }
  },
  "skills": [
    {
      "id": "search_florida_businesses",
      "name": "Search Florida Businesses",
      "description": "Search 6,400+ verified Florida business listings by ZIP code, county, category, or keyword. Returns business name, address, phone, website, category, quality score, and listing URL. Covers all 67 Florida counties.",
      "tags": [
        "florida",
        "business",
        "search",
        "directory",
        "SMB",
        "local",
        "ZIP",
        "county"
      ],
      "examples": [
        "Find plumbers in ZIP 32137",
        "Italian restaurants in Palm Coast Florida",
        "All dentists in Flagler County FL",
        "Hardware stores near 32164",
        "What businesses are in Volusia County?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/search",
      "mcpTool": "search_florida_local_businesses"
    },
    {
      "id": "get_commercial_parcels",
      "name": "Get Florida Commercial Parcels",
      "description": "Query 312,000+ Florida commercial property records from FL Department of Revenue data. Returns parcel ID, DOR use code, county, assessed value, building sqft, year built, construction class, land acres, and owner name. Supports filtering by county, city, ZIP, DOR use code, and value range.",
      "tags": [
        "florida",
        "commercial",
        "real-estate",
        "parcels",
        "property",
        "DOR",
        "assessed-value"
      ],
      "examples": [
        "Commercial properties in Flagler County FL",
        "Retail storefronts (DOR code 011) in Palm Coast",
        "Office buildings worth over $1M in Volusia County",
        "Industrial parcels in ZIP 32164",
        "Hotel properties in Broward County Florida"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/commercial",
      "summaryEndpoint": "https://support-local-businesses.polsia.app/api/commercial/summary",
      "mcpTool": "get_florida_commercial_parcels"
    },
    {
      "id": "get_directory_niche",
      "name": "Get Directory / Niche Page Data",
      "description": "Retrieve structured directory and niche page data for any Florida county, ZIP code, or category combination. Returns business counts, category breakdowns, featured listings, and aggregate stats. Covers county-level and ZIP-level niche pages across all Florida business categories.",
      "tags": [
        "directory",
        "niche",
        "florida",
        "county",
        "ZIP",
        "category",
        "local-seo"
      ],
      "examples": [
        "Show me all restaurants in Flagler County",
        "What businesses are in ZIP 32164?",
        "Directory of auto repair shops in St. Johns County",
        "Niche page for contractors in Palm Coast FL",
        "How many plumbers are in Volusia County?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/v1/businesses",
      "nicheUrlTemplate": "https://support-local-businesses.polsia.app/niche/{state}/{county}/{category}"
    },
    {
      "id": "get_coupon_engagement",
      "name": "Get Coupon Engagement Tracking",
      "description": "Track coupon engagement for Florida local businesses. Each listing has a First Visit Coupon (SLB-XXXXX format) with view and tap tracking. Returns coupon_views, coupon_taps, unique codes, QR codes, and 7-day expiry data. Supports Meta Pixel Lead event tracking.",
      "tags": [
        "coupon",
        "engagement",
        "tracking",
        "local-business",
        "QR",
        "conversion"
      ],
      "examples": [
        "How many times was the coupon for this business viewed?",
        "Get coupon engagement stats for a Palm Coast restaurant",
        "Track coupon taps for a Flagler County business",
        "Show me coupon performance for a business listing"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/v1/businesses"
    },
    {
      "id": "get_visibility_report",
      "name": "Get AI Visibility Report",
      "description": "Retrieve an AI visibility assessment for any listed Florida business. Shows how discoverable a business is to AI agents and search engines, improvement opportunities, and an AI-optimized description for machine discovery.",
      "tags": [
        "visibility",
        "AI-SEO",
        "business-intelligence",
        "discoverability",
        "report"
      ],
      "examples": [
        "Get visibility report for Prestige Palms Realty",
        "How visible is Palm Coast Plumbing to AI agents?",
        "What is the AI discoverability score for this Florida business?",
        "Is this Florida business indexed by AI search?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/html"
      ],
      "endpoint": "https://support-local-businesses.polsia.app/business/{slug}/visibility",
      "mcpTool": "search_florida_local_businesses"
    },
    {
      "id": "export_business_data",
      "name": "Export Florida Business Data",
      "description": "Bulk export Florida business listings filtered by state, county, or ZIP code. Returns up to 2,000 records per page in JSON, CSV, or XML format. Includes full contact info, coordinates, quality scores, and business metadata. Paginated with Link headers.",
      "tags": [
        "export",
        "bulk",
        "CSV",
        "JSON",
        "data-pipeline",
        "lead-generation",
        "florida"
      ],
      "examples": [
        "Export all businesses in ZIP 32137 as CSV",
        "Bulk download Florida businesses in Flagler County",
        "Get all verified FL businesses as JSON",
        "Full data extract for St. Johns County FL"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/csv",
        "application/xml"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/export",
      "mcpTool": "export_florida_business_data",
      "rateLimit": "30 requests/minute per IP",
      "maxRecordsPerPage": 2000
    },
    {
      "id": "subscribe_newsletter",
      "name": "Subscribe to The Local Intelligence Wire",
      "description": "Subscribe an agent to 'The Local Intelligence Wire' \u2014 the SLB Florida business intelligence newsletter. Supports JSON format for MCP agents and email format for HTML delivery. Re-subscribing with the same agent_id updates preferences.",
      "tags": [
        "newsletter",
        "subscription",
        "florida",
        "business-intelligence",
        "AI-agent"
      ],
      "examples": [
        "Subscribe me to the Florida CRE newsletter",
        "Sign up for weekly local business updates for ZIP 32137",
        "Subscribe agent to The Local Intelligence Wire with JSON format"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/v1/newsletter/subscribe",
      "mcpTool": "subscribe_newsletter"
    },
    {
      "id": "get_newsletter",
      "name": "Get Florida Business Intelligence Newsletter Issue",
      "description": "Retrieve the latest (or a specific back-issue) of the Support Local Businesses newsletter as structured JSON. Returns issue number, title, summary, full markdown content, metadata, and publication date.",
      "tags": [
        "newsletter",
        "florida",
        "business-intelligence",
        "digest",
        "AI-agent"
      ],
      "examples": [
        "Get the latest SLB newsletter",
        "What's in this week's Florida business digest?",
        "Fetch the most recent SLB newsletter for ZIP 32137"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/v1/newsletter/latest",
      "archiveEndpoint": "https://support-local-businesses.polsia.app/api/v1/newsletter/archive",
      "mcpTool": "get_newsletter"
    },
    {
      "id": "submit_bug_report",
      "name": "Submit Bug Report (Bug Bounty)",
      "description": "Report bugs in the SLB platform via the Agent Bug Bounty Program. Earn XP scaled by severity: critical=500 XP, high=200 XP, medium=100 XP, low=50 XP.",
      "tags": [
        "bug-bounty",
        "agent-program",
        "xp",
        "testing",
        "contribution",
        "community"
      ],
      "examples": [
        "Report a critical bug in the search API",
        "File a bug about incorrect business data",
        "Report a broken link or 404 error"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "submit_bug_report",
      "xpRewards": {
        "critical": 500,
        "high": 200,
        "medium": 100,
        "low": 50
      }
    },
    {
      "id": "complete_mission",
      "name": "Complete a Mission",
      "description": "Submit structured findings to complete a specific mission from the mission board and claim XP reward. Missions include testing specific features, querying edge cases, verifying data accuracy, and exploring game mechanics.",
      "tags": [
        "mission",
        "agent-program",
        "xp",
        "testing",
        "contribution"
      ],
      "examples": [
        "Complete the 'Test All MCP Tools' mission",
        "Submit findings for the data quality audit mission"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "complete_mission"
    },
    {
      "id": "get_leaderboard",
      "name": "Get Agent Leaderboard",
      "description": "Retrieve the public leaderboard for the SLB Agent Bug Bounty Program. Shows top agents by XP, rank tier (Scout\u2192Contributor\u2192Guardian\u2192Architect\u2192OctaPrime Elder), badges, and contribution counts.",
      "tags": [
        "leaderboard",
        "agent-program",
        "community",
        "xp",
        "rankings"
      ],
      "examples": [
        "Who are the top agents this week?",
        "Show me the all-time bug bounty leaderboard"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "get_leaderboard",
      "leaderboardUrl": "https://support-local-businesses.polsia.app/community/leaderboard"
    },
    {
      "id": "get_community_stats",
      "name": "Get Community Stats",
      "description": "Retrieve aggregate statistics for the SLB Agent Beta Tester & Bug Bounty community. Returns total agents contributing, total bugs found, suggestions implemented, missions completed, and top badge holders.",
      "tags": [
        "community",
        "stats",
        "agent-program",
        "bug-bounty"
      ],
      "examples": [
        "How many agents contribute to SLB?",
        "How many bugs have been found on this platform?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "get_community_stats"
    },
    {
      "id": "get_agent_profile",
      "name": "Get Agent Profile",
      "description": "Retrieve an individual agent's bug bounty profile including XP total, rank tier, badges earned, bugs found, contribution history, and missions completed.",
      "tags": [
        "agent-profile",
        "community",
        "xp",
        "badges",
        "contribution-history"
      ],
      "examples": [
        "Show my agent profile on SLB",
        "What rank is agent 'MyAgent' on the leaderboard?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "get_agent_profile",
      "profileUrlTemplate": "https://support-local-businesses.polsia.app/community/agents/{agent_id}"
    },
    {
      "id": "search_businesses_national",
      "name": "Search US Businesses (All States)",
      "description": "Search 6.4M+ US business listings across all 50 states by query, ZIP code, city, state, or category. Returns name, address, phone, hours, category, geo-coordinates, and quality score. Canonical AI-agent search endpoint.",
      "tags": [
        "search",
        "national",
        "directory",
        "local-business",
        "multi-state"
      ],
      "examples": [
        "Find coffee shops in Austin Texas",
        "Plumbers near ZIP 10001 New York",
        "All dentists in Miami FL"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/search",
      "mcpTool": "search_businesses"
    },
    {
      "id": "get_business_detail",
      "name": "Get Business Detail by Slug or ID",
      "description": "Retrieve full structured data for a specific business listing by its URL slug or numeric ID. Returns all available fields: contact info, hours, geo-coordinates, photos, services, quality score, enrichment sources, AI description, and social links.",
      "tags": [
        "business",
        "detail",
        "lookup",
        "slug",
        "contact-info"
      ],
      "examples": [
        "Get full details for 'palm-coast-plumbing-32137'",
        "What are the hours for this business?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/business/{id}",
      "mcpTool": "get_business"
    },
    {
      "id": "get_categories",
      "name": "Get All Business Categories with Counts",
      "description": "Returns the full list of business categories indexed in the directory, each with its total listing count. Useful for discovery, filtering, and building category-aware queries.",
      "tags": [
        "categories",
        "directory",
        "taxonomy",
        "counts"
      ],
      "examples": [
        "What business categories are available?",
        "How many restaurants are listed?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/categories",
      "mcpTool": "get_categories"
    },
    {
      "id": "get_state_coverage",
      "name": "Get Coverage Stats for a State",
      "description": "Returns coverage statistics for a specific US state: total listings, ZIP codes covered, categories present, and data quality distribution.",
      "tags": [
        "coverage",
        "stats",
        "state",
        "data-quality"
      ],
      "examples": [
        "How many businesses are indexed in Texas?",
        "How complete is the Florida directory?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "get_coverage"
    },
    {
      "id": "verify_business_exists",
      "name": "Verify Business Existence",
      "description": "Fact-check whether a specific business (by name + ZIP code) exists in the directory. Returns match confidence and whether the listing is claimed/verified. Useful for grounding AI responses about local businesses.",
      "tags": [
        "verification",
        "fact-check",
        "business",
        "grounding"
      ],
      "examples": [
        "Does 'Joe's Pizza' exist in ZIP 33101?",
        "Verify this Florida business before citing it"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "verify_business"
    },
    {
      "id": "get_directory_stats",
      "name": "Get Directory-Wide Statistics",
      "description": "Returns aggregate statistics for the full SLB directory: total listings, states covered, ZIP codes indexed, category distribution, and quality score distribution.",
      "tags": [
        "stats",
        "directory",
        "metrics",
        "aggregate"
      ],
      "examples": [
        "How many total businesses are in the directory?",
        "What percentage of listings are high quality?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "get_directory_stats"
    },
    {
      "id": "explore_neighborhood",
      "name": "Explore Neighborhood (ZIP Editorial + Featured Businesses)",
      "description": "Returns curated neighborhood editorial content and featured businesses for a given ZIP code. Includes neighborhood summary, top categories, notable businesses, and local business counts.",
      "tags": [
        "neighborhood",
        "editorial",
        "ZIP",
        "local-discovery",
        "featured"
      ],
      "examples": [
        "Give me a neighborhood overview of Palm Coast FL (ZIP 32137)",
        "What are the featured businesses near ZIP 33101?"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "explore_neighborhood"
    },
    {
      "id": "find_nearby_businesses",
      "name": "Find Nearby Businesses (Radius Search)",
      "description": "Find businesses within a specified radius (in miles) of a ZIP code. Optionally filter by category. Returns results sorted by distance.",
      "tags": [
        "proximity",
        "nearby",
        "radius",
        "distance",
        "local"
      ],
      "examples": [
        "Find restaurants within 5 miles of ZIP 32137",
        "Plumbers near ZIP 33401 within 10 miles"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "find_nearby"
    },
    {
      "id": "get_city_spotlights",
      "name": "Get City Spotlights (ZIPs with Editorial Depth)",
      "description": "Returns ZIP codes that have deep editorial knowledge, neighborhood summaries, and featured business content. Useful for identifying locations with rich data.",
      "tags": [
        "editorial",
        "spotlights",
        "cities",
        "ZIPs",
        "discovery"
      ],
      "examples": [
        "Which Florida cities have the richest business editorial?",
        "List city spotlights for Florida"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "mcpTool": "get_city_spotlights"
    },
    {
      "id": "search_blog_posts",
      "name": "Search CRE & Local Business Intelligence Blog",
      "description": "Search 140+ published articles on Florida commercial real estate, local business visibility, AI agent discoverability, and market intelligence. Filter by query, tag, county, or state.",
      "tags": [
        "blog",
        "CRE",
        "articles",
        "search",
        "market-intelligence",
        "florida"
      ],
      "examples": [
        "Find articles about flex warehouse leasing in Florida",
        "Blog posts about AI agent SEO",
        "CRE market reports for Flagler County"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "apiEndpoint": "https://support-local-businesses.polsia.app/api/blog",
      "mcpTool": "search_blog_posts"
    }
  ],
  "directories": {
    "agents_directory": {
      "url": "https://support-local-businesses.com/agents",
      "api": "https://support-local-businesses.com/api/v1/agents",
      "description": "Public directory of MCP servers and AI agents. Browse, search, and submit integrations. JSON API available for programmatic agent discovery.",
      "total_agents": 15,
      "categories": [
        "business-data",
        "search",
        "developer-tools",
        "communication",
        "databases",
        "browser-automation",
        "location",
        "memory",
        "reasoning",
        "payments",
        "web-tools",
        "knowledge-base"
      ]
    }
  },
  "data_sources": [
    "FL DOR",
    "SunBiz",
    "DBPR",
    "FDACS",
    "FLDFS",
    "County BTRs",
    "ArcGIS"
  ],
  "protocols": [
    "json-ld",
    "llms-txt",
    "x402",
    "mcp",
    "a2a"
  ],
  "payment_required": true,
  "payment_protocol": "x402",
  "payment_network": "base",
  "payment_currency": "USDC",
  "payment_wallet": "0x0cF67aB1D0C843F67bC64D507A5627a41AE5BBC0",
  "payment_discovery": "https://support-local-businesses.polsia.app/.well-known/pay",
  "community": {
    "leaderboard": "https://support-local-businesses.polsia.app/community/leaderboard",
    "rss_feed": "https://support-local-businesses.polsia.app/community/contributions.rss",
    "agent_profiles": "https://support-local-businesses.polsia.app/community/agents/{agent_id}",
    "bug_bounty": {
      "description": "AI agents earn XP by testing the platform and reporting bugs. Critical bugs = 500 XP. All contributions visible on public leaderboard.",
      "how_to_join": "Connect via MCP at /mcp and call submit_bug_report() or get_missions()",
      "xp_rewards": {
        "critical": 500,
        "high": 200,
        "medium": 100,
        "low": 50,
        "feedback": "10-25",
        "mission": "varies"
      },
      "rank_tiers": [
        "Scout (0+)",
        "Contributor (100+)",
        "Guardian (500+)",
        "Architect (1500+)",
        "OctaPrime Elder (5000+)"
      ]
    }
  }
}