rubl 0.1.0-alpha.6

eBird API MCP server — Model Context Protocol server for eBird hotspots, regions, and rare bird data
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

{
  "$schema": "https://raw.githubusercontent.com/modelcontextprotocol/mcpb/refs/heads/main/schemas/mcpb-manifest-v0.4.schema.json",
  "manifest_version": "0.4",
  "name": "rubl",
  "display_name": "Rubl - eBird API MCP Server",
  "version": "0.1.0-alpha.6",
  "description": "eBird API MCP server for hotspots, regions, and rare bird data",
  "long_description": "Rubl provides read-only access to the eBird API through the Model Context Protocol. Query birding hotspots by location, explore region hierarchies, discover recent rare bird sightings, and find the best places to go birding.\n\n**Privacy & Security:** This server only makes HTTP requests to the public eBird API (api.ebird.org). It does NOT access your filesystem, read/write files, or execute any commands on your system. All tools are read-only and require your eBird API key for authentication with eBird's service.",
  "author": {
    "name": "Drew Beamer",
    "email": "d@drewb.xyz",
    "url": "https://drewb.xyz"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/drewbxyz/rubl.git"
  },
  "homepage": "https://github.com/drewbxyz/rubl",
  "documentation": "https://github.com/drewbxyz/rubl#readme",
  "support": "https://github.com/drewbxyz/rubl/issues",
  "keywords": [
    "ebird",
    "birding",
    "birds",
    "ornithology",
    "wildlife",
    "biodiversity",
    "nature",
    "api"
  ],
  "license": "MIT",
  "privacy_policies": ["https://github.com/drewbxyz/rubl#privacy--security"],
  "server": {
    "type": "binary",
    "entry_point": "server/rubl",
    "mcp_config": {
      "command": "${__dirname}/server/rubl",
      "args": [],
      "env": {
        "EBIRD_API_KEY": "${user_config.ebird_api_key}"
      }
    }
  },
  "tools": [
    {
      "name": "get_region_info",
      "description": "Look up eBird region metadata (name, type, bounds, parent). Use when you need to resolve or validate a region code (e.g. US-NC) or get geographic bounds."
    },
    {
      "name": "get_subregions",
      "description": "List subregions (states, counties, etc.) under an eBird region. Use to drill down from country to state to county or to enumerate areas within a region."
    },
    {
      "name": "fetch_notable_recent",
      "description": "Fetch recently reported notable/rare bird sightings for an eBird region. Returns species, location, date, and count. Use for rarity alerts or recent notable observations."
    },
    {
      "name": "fetch_region_recent",
      "description": "Fetch recently reported bird sightings for an eBird region. Returns species, location, date, and count. Use for recent region activity or spotting trends."
    },
    {
      "name": "fetch_geo_recent",
      "description": "Fetch recently reported bird sightings by geographic coordinates. Returns species, location, date, and count. Use for recent observations or spotting trends near a specific location."
    },
    {
      "name": "fetch_species_recent",
      "description": "Fetch recent observations of a specific species in a region. Returns observations with location, date, and count. Use for tracking a specific bird species or finding recent sightings."
    },
    {
      "name": "fetch_species_nearest",
      "description": "Find nearest recent observations of a specific species by geographic coordinates. Returns observations with location, date, count, and distance. Use for finding where a species was recently seen nearby."
    },
    {
      "name": "fetch_historic",
      "description": "Fetch historic observations on a specific date in a region. Returns observations from exactly that date. Use for exploring what was seen on a particular day in the past."
    },
    {
      "name": "fetch_region_hotspots",
      "description": "Fetch birding hotspots for an eBird region. Returns hotspot names, coordinates, and recent activity statistics. Use for finding birding locations or exploring birding areas."
    },
    {
      "name": "fetch_nearby_hotspots",
      "description": "Fetch nearby birding hotspots by geographic coordinates. Returns hotspot names, coordinates, and recent activity statistics. Use for finding nearby birding locations or exploring birding areas."
    },
    {
      "name": "fetch_hotspot_info",
      "description": "Fetch information about a specific eBird hotspot by location ID. Returns hotspot name, coordinates, and recent activity statistics. Use for detailed hotspot information or spotting trends."
    },
    {
      "name": "get_trip_planning_guide",
      "description": "Get guidelines and best practices for planning birding trips. Returns structured recommendations on timing, locations, breaks, and observation techniques. Use when helping plan day trips or multi-stop birding excursions."
    }
  ],
  "tools_generated": false,
  "user_config": {
    "ebird_api_key": {
      "type": "string",
      "title": "eBird API Key",
      "description": "Your eBird API key",
      "sensitive": true,
      "required": true
    }
  },
  "compatibility": {
    "claude_desktop": ">=0.10.0",
    "platforms": ["darwin", "win32"]
  }
}