rescuedogs-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ssatama
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,201 @@
+# rescuedogs-mcp-server
+
+[![npm version](https://badge.fury.io/js/rescuedogs-mcp-server.svg)](https://www.npmjs.com/package/rescuedogs-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+### Search by lifestyle
+![Search demo](demo-1.png)
+
+### Get detailed profiles
+![Detail demo](demo-2.png)
+
+MCP server for discovering rescue dogs from European and UK organizations. Search, filter, and get detailed profiles of dogs available for adoption.
+
+## Installation
+
+```bash
+npm install -g rescuedogs-mcp-server
+```
+
+## Claude Desktop Configuration
+
+Add to `~/.config/claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "rescuedogs": {
+      "command": "npx",
+      "args": ["-y", "rescuedogs-mcp-server"]
+    }
+  }
+}
+```
+
+## Available Tools
+
+### rescuedogs_search_dogs
+
+Search for rescue dogs with comprehensive filtering.
+
+```
+"Find medium-sized dogs good for first-time owners"
+"Show me golden retrievers available to adopt in the UK"
+"Find low-energy dogs suitable for apartments"
+```
+
+**Parameters:**
+- `query` - Free-text search
+- `breed` - Filter by breed name
+- `breed_group` - Filter by FCI group (Herding, Sporting, etc.)
+- `size` - Tiny, Small, Medium, Large, XLarge
+- `age_category` - puppy, young, adult, senior
+- `sex` - male, female
+- `energy_level` - low, medium, high, very_high
+- `experience_level` - first_time_ok, some_experience, experienced_only
+- `home_type` - apartment_ok, house_preferred, house_required
+- `adoptable_to_country` - ISO country code (GB, IE, FR, DE)
+- `include_images` - Include dog photos (default: false)
+
+### rescuedogs_get_dog_details
+
+Get full details for a specific dog including AI-generated personality profile.
+
+```
+"Tell me about the dog with slug 'buddy-12345'"
+"Show me details for Max"
+```
+
+**Parameters:**
+- `slug` - Dog's URL slug (required)
+- `include_image` - Include photo (default: true)
+
+### rescuedogs_list_breeds
+
+Get available breeds with counts and statistics.
+
+```
+"What breeds are available?"
+"Show me herding breeds with at least 10 dogs"
+```
+
+**Parameters:**
+- `breed_group` - Filter by FCI group
+- `min_count` - Minimum dogs available
+- `limit` - Number of breeds to return
+
+### rescuedogs_get_statistics
+
+Get overall platform statistics.
+
+```
+"How many rescue dogs are available?"
+"Show me platform statistics"
+```
+
+### rescuedogs_get_filter_counts
+
+Get available filter options with counts based on current filters.
+
+```
+"What filter options are available if I've selected Labrador breed?"
+"Show me available sizes for dogs in Spain"
+```
+
+### rescuedogs_list_organizations
+
+List rescue organizations with their statistics.
+
+```
+"Which rescue organizations are in the UK?"
+"Show me all organizations"
+```
+
+### rescuedogs_match_preferences
+
+Find dogs matching your lifestyle preferences.
+
+```
+"I live in an apartment, have moderate activity, and am a first-time dog owner"
+"Find dogs for an active family with a house and garden"
+```
+
+**Parameters:**
+- `living_situation` - apartment, house_small_garden, house_large_garden, rural
+- `activity_level` - sedentary, moderate, active, very_active
+- `experience` - first_time, some, experienced
+- `has_children`, `has_other_dogs`, `has_cats` - boolean
+- `adoptable_to_country` - ISO country code
+
+### rescuedogs_get_adoption_guide
+
+Get information about the rescue dog adoption process.
+
+```
+"How does rescue dog adoption work?"
+"Tell me about transport for adopting to the UK"
+"What fees should I expect?"
+```
+
+**Parameters:**
+- `topic` - overview, transport, fees, requirements, timeline
+- `country` - ISO code for country-specific info
+
+## Geographic Scope
+
+This server covers **European and UK rescue organizations only**:
+
+- United Kingdom
+- Ireland
+- Germany
+- France
+- Spain
+- Italy
+- Romania
+- Greece
+- Bulgaria
+- Cyprus
+- And more...
+
+US, Canadian, and Australian rescues are not supported.
+
+## Country Codes
+
+Use these codes for the `adoptable_to_country` parameter:
+
+| Code | Country |
+|------|---------|
+| GB | United Kingdom (UK also accepted) |
+| IE | Ireland |
+| DE | Germany |
+| FR | France |
+| ES | Spain |
+| IT | Italy |
+| NL | Netherlands |
+| BE | Belgium |
+| AT | Austria |
+| RO | Romania |
+| GR | Greece |
+| BG | Bulgaria |
+| CY | Cyprus |
+
+Dogs can be adopted to countries where the rescue organization ships to. Use `rescuedogs_list_organizations` to see which countries each organization serves.
+
+## Data Source
+
+All data comes from [rescuedogs.me](https://www.rescuedogs.me), aggregating listings from vetted rescue organizations.
+
+- 1,500+ available dogs
+- 12+ rescue organizations
+- 370+ breeds
+- 96% AI personality profile coverage
+
+The platform is powered by the open-source [rescue-dog-aggregator](https://github.com/ssatama/rescue-dog-aggregator) project, which handles web scraping, data standardization, AI-powered personality extraction, and the public API.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Issues and PRs welcome!
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -0,0 +1,22 @@
+export declare const API_BASE_URL = "https://api.rescuedogs.me";
+export declare const CHARACTER_LIMIT = 25000;
+export declare const CACHE_TTL: {
+    readonly BREEDS: number;
+    readonly STATISTICS: number;
+    readonly ORGANIZATIONS: number;
+    readonly FILTER_COUNTS: number;
+    readonly IMAGES: number;
+};
+export declare const IMAGE_TRANSFORMS: {
+    readonly thumbnail: "w=200,h=200,fit=cover,q=70,f=jpeg";
+    readonly medium: "w=400,h=400,fit=cover,q=75,f=jpeg";
+};
+export declare const IMAGE_BASE_URL = "https://images.rescuedogs.me";
+export declare const DEFAULT_LIMIT = 10;
+export declare const MAX_LIMIT = 50;
+export declare const MIN_LIMIT = 1;
+export declare const PAGINATION_DEFAULTS: {
+    readonly limit: 10;
+    readonly offset: 0;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,8BAA8B,CAAC;AAExD,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AAEX,eAAO,MAAM,cAAc,iCAAiC,CAAC;AAE7D,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,22 @@
+export const API_BASE_URL = "https://api.rescuedogs.me";
+export const CHARACTER_LIMIT = 25000;
+export const CACHE_TTL = {
+    BREEDS: 10 * 60 * 1000, // 10 minutes
+    STATISTICS: 10 * 60 * 1000, // 10 minutes
+    ORGANIZATIONS: 10 * 60 * 1000, // 10 minutes
+    FILTER_COUNTS: 5 * 60 * 1000, // 5 minutes
+    IMAGES: 30 * 60 * 1000, // 30 minutes
+};
+export const IMAGE_TRANSFORMS = {
+    thumbnail: "w=200,h=200,fit=cover,q=70,f=jpeg",
+    medium: "w=400,h=400,fit=cover,q=75,f=jpeg",
+};
+export const IMAGE_BASE_URL = "https://images.rescuedogs.me";
+export const DEFAULT_LIMIT = 10;
+export const MAX_LIMIT = 50;
+export const MIN_LIMIT = 1;
+export const PAGINATION_DEFAULTS = {
+    limit: DEFAULT_LIMIT,
+    offset: 0,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,2BAA2B,CAAC;AAExD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IACrC,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IACzC,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;IAC5C,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAC1C,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,aAAa;CAC7B,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS,EAAE,mCAAmC;IAC9C,MAAM,EAAE,mCAAmC;CACnC,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,8BAA8B,CAAC;AAE7D,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAE3B,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,CAAC;CACD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}