{"_id":"@biznezstack/propertydata-mcp","name":"@biznezstack/propertydata-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@biznezstack/propertydata-mcp","version":"1.0.0","description":"MCP server for PropertyData UK property market API - Access 60+ endpoints for property valuations, market analysis, demographics, and area intelligence through Claude Desktop","type":"module","main":"./build/index.js","bin":{"propertydata-mcp":"build/index.js"},"scripts":{"build":"tsc && chmod +x build/index.js","prepare":"npm run build","watch":"tsc --watch","test":"node build/index.js","clean":"rm -rf build","prepublishOnly":"npm run clean && npm run build"},"keywords":["mcp","model-context-protocol","propertydata","uk-property","real-estate","property-data","property-valuation","property-analytics","uk-real-estate","claude","anthropic","property-market","rental-yields","property-prices","demographics","area-analysis"],"author":{"name":"BiznezStack","email":"hello@biznezstack.com"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","node-fetch":"^3.3.2"},"devDependencies":{"@types/node":"^20.10.0","@types/node-fetch":"^2.6.11","typescript":"^5.3.0"},"engines":{"node":">=18.0.0","npm":">=9.0.0"},"repository":{"type":"git","url":"git+https://github.com/mmaun/propertydata-mcp.git"},"bugs":{"url":"https://github.com/mmaun/propertydata-mcp/issues"},"homepage":"https://github.com/mmaun/propertydata-mcp/blob/main/README.md","publishConfig":{"access":"public"},"_id":"@biznezstack/propertydata-mcp@1.0.0","gitHead":"1818aaf9ac0a744cc4fe4b69398747e70c9c223b","types":"./build/index.d.ts","_nodeVersion":"22.18.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-Lof4ipQHmjMkuah1uHNtQAWiVEXtlE0xQlv33q/mU7V6vfgn/3TWYr0oNpCF6elRwbLoQu/UPWdqCtipDToHKg==","shasum":"2caccfdfd6f704c85a763684a68b875ce6750211","tarball":"https://registry.npmjs.org/@biznezstack/propertydata-mcp/-/propertydata-mcp-1.0.0.tgz","fileCount":6,"unpackedSize":64790,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGxYLaEexmPDaJCUxLVtvzXyi16vOo4PrITtP6+p6PIdAiEA1NbxUT4e0kcOR1JDNtfA+9mtyHrl9IX9bwpGlhZGXYY="}]},"_npmUser":{"name":"biznezstack","email":"hello@biznezstack.com"},"directories":{},"maintainers":[{"name":"biznezstack","email":"hello@biznezstack.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/propertydata-mcp_1.0.0_1759473963887_0.8736960957151696"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-03T06:46:03.769Z","1.0.0":"2025-10-03T06:46:04.081Z","modified":"2025-10-03T06:46:04.368Z"},"maintainers":[{"name":"biznezstack","email":"hello@biznezstack.com"}],"description":"MCP server for PropertyData UK property market API - Access 60+ endpoints for property valuations, market analysis, demographics, and area intelligence through Claude Desktop","homepage":"https://github.com/mmaun/propertydata-mcp/blob/main/README.md","keywords":["mcp","model-context-protocol","propertydata","uk-property","real-estate","property-data","property-valuation","property-analytics","uk-real-estate","claude","anthropic","property-market","rental-yields","property-prices","demographics","area-analysis"],"repository":{"type":"git","url":"git+https://github.com/mmaun/propertydata-mcp.git"},"author":{"name":"BiznezStack","email":"hello@biznezstack.com"},"bugs":{"url":"https://github.com/mmaun/propertydata-mcp/issues"},"license":"MIT","readme":"# PropertyData MCP Server\n\nA Model Context Protocol (MCP) server that provides seamless access to the PropertyData UK property market API through Claude Desktop and other MCP clients.\n\n[![npm version](https://badge.fury.io/js/%40yourname%2Fpropertydata-mcp.svg)](https://www.npmjs.com/package/@yourname/propertydata-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## 🏠 Features\n\nAccess comprehensive UK property data including:\n\n- **Property Valuations**: Sale, rental, and HMO valuations\n- **Market Analysis**: Current prices, historical sales, growth trends\n- **Area Intelligence**: Demographics, crime stats, schools, amenities\n- **Rental Data**: Rental prices, yields, demand analytics, LHA rates\n- **Development Tools**: Build costs, GDV calculations, planning data\n- **Location Data**: Flood risk, transport links, energy efficiency\n- **Regulatory Info**: Conservation areas, green belt, planning applications\n- **Financial Tools**: Council tax, stamp duty calculator\n\n**60+ endpoints** covering every aspect of UK property analysis!\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n1. **Get a PropertyData API Key**\n   - Sign up at [PropertyData.co.uk](https://propertydata.co.uk)\n   - Navigate to your account settings\n   - Copy your API key\n\n2. **Have Claude Desktop Installed**\n   - Download from [claude.ai](https://claude.ai/download)\n\n### Installation\n\nNo installation needed! Just configure Claude Desktop:\n\n#### For macOS\n\n1. Open the config file:\n   ```bash\n   code ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n   ```\n   Or manually navigate to: `~/Library/Application Support/Claude/`\n\n2. Add this configuration:\n   ```json\n   {\n     \"mcpServers\": {\n       \"propertydata\": {\n         \"command\": \"npx\",\n         \"args\": [\n           \"-y\",\n           \"@yourname/propertydata-mcp\"\n         ],\n         \"env\": {\n           \"PROPERTYDATA_API_KEY\": \"your-api-key-here\"\n         }\n       }\n     }\n   }\n   ```\n\n#### For Windows\n\n1. Open the config file:\n   ```\n   %APPDATA%\\Claude\\claude_desktop_config.json\n   ```\n\n2. Add the same configuration as above\n\n### Restart Claude Desktop\n\nQuit Claude completely (not just close the window) and restart it.\n\n## ✅ Verify Installation\n\nAsk Claude:\n```\nCan you check the PropertyData MCP server connection?\n```\n\nThen try a real query:\n```\nGet property prices for postcode SW1A 1AA\n```\n\n## 📚 Available Tools\n\n### Address & Property Lookup\n- `address_match_uprn` - Match address to UPRN\n- `get_uprn_data` - Get property details by UPRN\n- `get_uprns` - Get all UPRNs in postcode\n- `get_uprn_title` - Get land registry title for UPRN\n- `get_title_data` - Get land registry data\n\n### Property Valuations\n- `get_valuation_sale` - Sale price valuations\n- `get_valuation_rent` - Rental valuations\n- `get_valuation_hmo` - HMO valuations\n\n### Market Data & Prices\n- `get_prices` - Current property prices\n- `get_prices_per_sqf` - Prices per square foot\n- `get_sold_prices` - Historical sales data\n- `get_growth_data` - Price growth trends\n\n### Rental Market\n- `get_rents` - Rental prices\n- `get_rents_hmo` - HMO rental prices\n- `get_yields` - Rental yields\n- `get_rental_demand` - Demand analytics\n- `get_lha_rate` - Local Housing Allowance rates\n\n### Area Analysis\n- `get_demographics` - Population demographics\n- `get_population_data` - Population statistics\n- `get_household_income` - Income data\n- `get_postcode_key_stats` - Key area statistics\n- `analyse_buildings` - Building analysis\n- `get_estate_agents` - Local estate agents\n\n### Development & Investment\n- `get_sourced_properties` - Investment opportunities\n- `development_calculator` - Development metrics\n- `get_build_cost` - Building cost estimates\n\n### Planning & Regulations\n- `get_planning_applications` - Planning applications\n- `get_conservation_area` - Conservation area status\n- `get_green_belt` - Green belt status\n\n### Location & Amenities\n- `get_flood_risk` - Flood risk data\n- `get_crime_data` - Crime statistics\n- `get_schools_data` - Schools information\n- `get_energy_efficiency` - EPC ratings\n\n### Financial\n- `get_council_tax` - Council tax information\n- `stamp_duty_calculator` - Calculate stamp duty\n\n### Account\n- `get_account_credits` - Check API credits\n\n## 💡 Example Queries\n\nAsk Claude natural questions like:\n\n```\nWhat's the average property price in SW1A?\n\nGet me a rental valuation for 10 Downing Street, SW1A 2AA\n\nShow me crime statistics for postcode E1 6AN\n\nWhat are the demographics of the N1 area?\n\nCalculate stamp duty for a £500,000 property\n\nFind HMO rental yields in M1 postcode\n\nWhat's the flood risk for property in RG1?\n\nGet planning applications in OX1 postcode\n```\n\n## 🔧 Advanced Configuration\n\n### Multiple Servers\n\nYou can run multiple MCP servers:\n\n```json\n{\n  \"mcpServers\": {\n    \"propertydata\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@yourname/propertydata-mcp\"],\n      \"env\": {\n        \"PROPERTYDATA_API_KEY\": \"your-key-here\"\n      }\n    },\n    \"another-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@another/mcp-server\"]\n    }\n  }\n}\n```\n\n### Use Specific Version\n\nPin to a specific version:\n\n```json\n{\n  \"mcpServers\": {\n    \"propertydata\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"@yourname/propertydata-mcp@1.0.0\"\n      ],\n      \"env\": {\n        \"PROPERTYDATA_API_KEY\": \"your-key-here\"\n      }\n    }\n  }\n}\n```\n\n## 🐛 Troubleshooting\n\n### Server Not Appearing\n\n1. **Check JSON syntax** - Use [jsonlint.com](https://jsonlint.com) to validate\n2. **Restart Claude completely** - Quit from menu, don't just close window\n3. **Check logs**:\n   - macOS: `~/Library/Logs/Claude/`\n   - Windows: `%APPDATA%\\Claude\\logs\\`\n\n### API Key Issues\n\n```\nERROR: PROPERTYDATA_API_KEY environment variable is required\n```\n\n**Solution**: Verify the API key is correctly set in the `env` section\n\n### Connection Errors\n\n- Ensure you have an active internet connection\n- Verify your PropertyData API key is valid\n- Check your PropertyData account has available credits\n\n### NPX Not Found\n\n**Solution**: Install Node.js from [nodejs.org](https://nodejs.org) (includes npm and npx)\n\n### Slow First Start\n\nThe first time you run the server, npx downloads the package. This is normal and only happens once.\n\n## 📖 API Documentation\n\nFor detailed information about each endpoint and data returned, see:\n- [PropertyData API Documentation](https://propertydata.co.uk/api/documentation)\n- [PropertyData API Guide](https://propertydata.co.uk/api)\n\n## 🔐 Security Notes\n\n- **Never commit your API key** to version control\n- Keep your `claude_desktop_config.json` private\n- API keys are only stored locally on your machine\n- The MCP server only communicates with PropertyData API\n\n## 🛠️ Development\n\nWant to modify or extend this server?\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/propertydata-mcp.git\ncd propertydata-mcp\n\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Test locally (requires API key)\nexport PROPERTYDATA_API_KEY=\"your-key\"\nnpm test\n```\n\n## 📝 License\n\nMIT License - see [LICENSE](LICENSE) file for details\n\n## 🤝 Contributing\n\nContributions welcome! Please feel free to submit a Pull Request.\n\n## 💬 Support\n\n- **MCP Server Issues**: [GitHub Issues](https://github.com/yourusername/propertydata-mcp/issues)\n- **PropertyData API**: [PropertyData Support](https://propertydata.co.uk/contact)\n- **MCP Protocol**: [MCP Documentation](https://modelcontextprotocol.io)\n\n## 🔗 Links\n\n- [PropertyData Website](https://propertydata.co.uk)\n- [Claude Desktop](https://claude.ai/download)\n- [Model Context Protocol](https://modelcontextprotocol.io)\n- [npm Package](https://www.npmjs.com/package/@yourname/propertydata-mcp)\n\n## 📊 Version History\n\n### 1.0.0 (Latest)\n- Initial release\n- 40+ PropertyData API endpoints\n- Full MCP protocol support\n- NPX deployment support\n\n---\n\n**Made with ❤️ for UK property professionals**","readmeFilename":"README.md","_rev":"1-e9d46070dd631f7de1bfda3f5f28916c"}