{
  "info": {
    "name": "Foursquare — mcp.ai",
    "description": "REST API for the Foursquare MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/foursquare",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "foursquare_autocomplete_places",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/autocomplete/places",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "autocomplete",
            "places"
          ]
        },
        "description": "Returns autocomplete suggestions for places as the user types their search query. This endpoint provides real-time search suggestions including places, search terms, and geographic areas. Use this act",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ll\": \"\",\n  \"bias\": \"\",\n  \"limit\": 0,\n  \"query\": \"\",\n  \"types\": \"\",\n  \"radius\": 0,\n  \"session_token\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "foursquare_get_trending_venues",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/trending/venues",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "trending",
            "venues"
          ]
        },
        "description": "Retrieves venues currently trending in a specified geographic area, sorted by popularity based on recent foot traffic and activity patterns. This action identifies places experiencing increased visito",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ll\": \"\",\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"radius\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "foursquare_retrieve_nearby_places_v3",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/nearby/places/v3",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "nearby",
            "places",
            "v3"
          ]
        },
        "description": "The GetNearbyPlaces endpoint retrieves a list of places near a specified location, primarily supporting check-in use cases and local discovery. It returns points of interest (POIs) including lower qua",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ll\": \"\",\n  \"hacc\": 0,\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"altitude\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "foursquare_retrieve_place_photos_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/place/photos/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "place",
            "photos",
            "by",
            "id"
          ]
        },
        "description": "Retrieves photos associated with a specific place in Foursquare's database. This endpoint allows you to access user-generated images for a particular point of interest (POI) using its unique Foursquar",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sort\": \"\",\n  \"limit\": 0,\n  \"fsq_id\": \"\",\n  \"classifications\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "foursquare_retrieve_place_tips_using_fsq_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/place/tips/using/fsq/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "place",
            "tips",
            "using",
            "fsq",
            "id"
          ]
        },
        "description": "Retrieves user-generated tips for a specific place in the Foursquare database. This endpoint allows you to fetch valuable insights and experiences shared by Foursquare users about a particular venue. ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sort\": \"\",\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"fsq_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "foursquare_retrieve_places_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/places/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "places",
            "by",
            "id"
          ]
        },
        "description": "Retrieves detailed information about a specific place using its unique Foursquare ID (FSQ ID). This endpoint provides comprehensive data about a venue, including its name, address, category, ratings, ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"fields\": \"\",\n  \"fsq_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "foursquare_search_places_api_request",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/places/api/request",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "places",
            "api",
            "request"
          ]
        },
        "description": "The GetPlacesSearch endpoint allows you to search for places in the Foursquare database based on various criteria such as location, keywords, and categories. This tool is ideal for discovering nearby ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ll\": \"\",\n  \"ne\": \"\",\n  \"sw\": \"\",\n  \"near\": \"\",\n  \"limit\": 0,\n  \"query\": \"\",\n  \"fields\": \"\",\n  \"radius\": 0,\n  \"open_at\": \"\",\n  \"open_now\": false,\n  \"max_price\": 0,\n  \"min_price\": 0,\n  \"super_venue_id\": \"\",\n  \"exclude_all_chains\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "foursquare_validate_credential",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/validate/credential",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "validate",
            "credential"
          ]
        },
        "description": "Validates Foursquare API credentials by performing a lightweight place search. This action verifies that the provided API key is valid and has proper access to the Foursquare Places API. Use this acti",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}