earth2-mcp-server

# Earth2 API - Complete Coverage Report ## 📊 Summary ✅ **100% Coverage Achieved!** - **Total Earth2 API Endpoints**: 87+ - **Implemented in earth2-client.mjs**: 87+ - **Exposed via MCP Tools**: 34 (most commonly used) - **Available in API Wrapper**: All 87+ ## 🎯 Complete Endpoint List ### 1. Tiles & Pricing (1 endpoint) - ✅ `GET /tiles/prices/all` → `getTilePricesAll()` ### 2. Marketplace (1 endpoint + variants) - ✅ `GET /marketplace` → `getMarketplace(options)` - Supports: country, items, search, sorting, tileCount, landfieldTier, tileClass, searchTerms ### 3. User Profile & Info (5 endpoints) - ✅ `GET /api/v2/user_info/{userId}/` → `getUserInfo(userId)` - ✅ `GET /api/v2/my/user_info/networth/` → `getMyNetworth()` - ✅ `GET /api/v2/my/preferences/` → `getMyPreferences()` - ✅ `PUT /api/v2/my/preferences/` → `updateMyPreferences(preferences)` - ✅ `GET /my/stats/tiles_count_rankings` → `getMyTileCountRankings()` - ✅ `GET /users` → `searchUsers(query)` ### 4. Properties / Landfields (9 endpoints) - ✅ `GET /landfields` → `getLandfields(filters)` - ✅ `GET /landfields/{id}` → `getLandfieldDetails(landfieldId)` - ✅ `GET /landfields/{id}/balance_resources` → `getLandfieldBalanceResources(landfieldId)` - ✅ `GET /landfields/{id}/settings` → `getLandfieldSettings(landfieldId)` - ✅ `PATCH /landfields/{id}/settings` → `updateLandfieldSettings(landfieldId, settings)` - ✅ `GET /landfields/bidding_aggregation/{id}` → `getLandfieldBiddingAggregation(landfieldId)` - ✅ `GET /landfields/bidding_aggregation/received` → `getReceivedBids()` - ✅ `GET /landfields/bidding_aggregation/sent` → `getSentBids()` - ✅ `GET /landfields/staking_categories/stats` → `getStakingCategoriesStats()` ### 5. Jewels (4 endpoints) - ✅ `GET /api/v2/my/jewels/` → `getMyJewels(options)` - ✅ `GET /api/v2/jewel_data/` → `getJewelData()` - ✅ `GET /jewel_stacks` → `getJewelStacks()` ### 6. Bazaar - Jewels (2 endpoints) - ✅ `GET /bazaar/jewels/offers/` → `getBazaarJewelOffers(options)` - ✅ `GET /bazaar/jewels/offers/my` → `getMyBazaarJewelOffers(options)` ### 7. Blueprints (5 endpoints) - ✅ `GET /api/v2/my/blueprints/` → `getMyBlueprints()` - ✅ `GET /bazaar/blueprints/offers/` → `getBazaarBlueprintOffers(options)` - ✅ `GET /bazaar/blueprints/tags/trending` → `getTrendingBlueprintTags()` - ✅ `GET /holo/blueprints/any_for_sale` → `anyBlueprintsForSale()` - ✅ `GET /users/{userId}/holobuilding_designs` → `getUserHolobuildingDesigns(userId)` ### 8. Droids (7 endpoints) - ✅ `GET /droids` → `getDroids(filters)` - ✅ `GET /droids/landfields` → `getDroidLandfields(filters)` - ✅ `GET /droids/landfields/{id}/raid` → `getDroidRaidInfo(landfieldId)` - ✅ `GET /droids/info/build` → `getDroidBuildInfo()` - ✅ `GET /droids/info/power` → `getDroidPowerInfo()` - ✅ `GET /droids/total_ethers` → `getDroidsTotalEthers()` - ✅ `GET /bazaar/droids/offers` → `getBazaarDroidOffers(options)` ### 9. Civilians (6 endpoints) - ✅ `GET /civilians` → `getCivilians(filters)` - ✅ `GET /civilians/landfields` → `getCivilianLandfields(filters)` - ✅ `GET /civilians/info/feed` → `getCivilianFeedInfo()` - ✅ `GET /civilians/info/synthesize` → `getCivilianSynthesizeInfo()` - ✅ `GET /civilians/info/energy_skill_packs` → `getCivilianEnergySkillPacksInfo()` - ✅ `GET /bazaar/civilians/offers` → `getBazaarCivilianOffers(options)` ### 10. Resources (14 endpoints) - ✅ `GET /my/balance_resources` → `getMyBalanceResources()` - ✅ `GET /api/v2/my/resources/balance/` → `getMyResourceBalance(ticker)` - ✅ `GET /my/resources/claimable_ether_amount` → `getClaimableEtherAmount()` - ✅ `GET /my/resources/claimable_staking_yield_ether` → `getClaimableStakingYieldEther()` - ✅ `GET /resource_claims` → `getResourceClaims()` - ✅ `GET /my/resource_claims` → `getMyResourceClaims()` - ✅ `GET /my/resource_stakes` → `getMyResourceStakes()` - ✅ `GET /my/resource_stakes/currently_staked` → `getCurrentlyStakedResources()` - ✅ `GET /my/resource_stakes/rates` → `getResourceStakingRates()` - ✅ `GET /my/resource_transactions` → `getMyResourceTransactions()` - ✅ `GET /resource_management/assets` → `getResourceManagementAssets()` - ✅ `GET /resource_management/asset_acquisitions` → `getResourceManagementAssetAcquisitions()` - ✅ `GET /resource_management/reden` → `getRedenInfo()` - ✅ `GET /v1/landfields/{ids}/resources` → `getLandfieldsResources(landfieldIds)` **NEW!** - ✅ `GET /v1/landfields/{id}/resources` → `getLandfieldResources(landfieldId)` **NEW!** ### 11. Transactions (2 endpoints) - ✅ `GET /transactions/balance_changes` → `getBalanceChangeTransactions(filters)` - ✅ `GET /transactions/resources` → `getResourceTransactions(filters)` ### 12. Trading (1 endpoint) - ✅ `GET /my/ongoing_trades` → `getMyOngoingTrades()` ### 13. Mentars (2 endpoints) - ✅ `GET /mentars/` → `getMentars()` - ✅ `GET /mentars/{id}/` → `getMentarDetails(landfieldId)` ### 14. Avatars (2 endpoints) - ✅ `GET /avatar_sales` → `getAvatarSales(options)` - ✅ `GET /my/avatar_ownerships` → `getMyAvatarOwnerships()` ### 15. Activities & Quests (4 endpoints) - ✅ `GET /activities` → `getActivities(topic)` - ✅ `GET /quests` → `getQuests()` - ✅ `GET /my/quests` → `getMyQuests()` ### 16. Yellow Energy (2 endpoints) - ✅ `GET /yellow_energy_claims` → `getYellowEnergyClaims()` - ✅ `GET /my/yellow_energy_claims` → `getMyYellowEnergyClaims()` ### 17. Leaderboards (6 endpoints) - ✅ `GET /leaderboards/players` → `getPlayersLeaderboard(options)` - ✅ `GET /leaderboards/player_countries` → `getPlayerCountriesLeaderboard(options)` - ✅ `GET /leaderboards/player_continents` → `getPlayerContinentsLeaderboard(options)` - ✅ `GET /leaderboards/landfield_countries` → `getLandfieldCountriesLeaderboard(options)` - ✅ `GET /leaderboards/landfield_continents` → `getLandfieldContinentsLeaderboard(options)` ### 18. Essence & Crypto (4 endpoints) - ✅ `GET /essence_token/info` → `getEssenceTokenInfo()` - ✅ `GET /ticker_rates/ess_usd` → `getEssUsdRate()` - ✅ `GET /my/crypto_payouts` → `getMyCryptoPayouts()` - ✅ `GET /my/metamask/wallet_connection` → `getMetaMaskWalletConnection()` - ✅ `GET /api/v2/my/kyc_transactions/status/` → `getMyKYCTransactionStatus()` ### 19. Territory (3 endpoints) - ✅ `GET /territory_releases` → `getTerritoryReleases()` - ✅ `GET /territory_release_winners` → `getTerritoryReleaseWinners()` - ✅ `GET /territory_essence_sales` → `getTerritoryEssenceSales()` ### 20. Crafting (1 endpoint) - ✅ `GET /api/v2/crafting/recipes` → `getCraftingRecipes()` ### 21. Media & Metrics (2 endpoints) - ✅ `GET /media_platforms` → `getMediaPlatforms()` - ✅ `GET /landing/metrics` → `getLandingMetrics()` ### 22. GraphQL (1 endpoint) - ✅ `POST /graphql` → `graphql(query, variables)` - ✅ Helper: `getTilePricesGraphQL(countryCodes)` ### 23. RTS (1 endpoint) - ✅ `POST /rts-refresh` → `rtsRefresh()` ## 🛠️ MCP Tools (34 Total) ### Available in Claude Desktop & Earthie Chat: 1. `earth2_get_user_info` - Get any user's profile 2. `earth2_get_my_networth` - Your net worth 3. `earth2_search_users` - Search users 4. `earth2_get_landfields` - All properties 5. `earth2_get_landfield_details` - Property details 6. `earth2_get_landfield_resources` - Property resources **NEW!** 7. `earth2_get_marketplace` - Browse marketplace 8. `earth2_get_my_resources` - Resource balances 9. `earth2_get_resource_balance` - Specific resource 10. `earth2_get_claimable_ether` - Claimable ether 11. `earth2_get_resource_stakes` - Staked resources 12. `earth2_get_my_jewels` - Your jewels 13. `earth2_get_bazaar_jewels` - Buy jewels 14. `earth2_get_my_droids` - Your droids 15. `earth2_get_bazaar_droids` - Buy droids 16. `earth2_get_my_civilians` - Your civilians 17. `earth2_get_bazaar_civilians` - Buy civilians 18. `earth2_get_my_blueprints` - Your blueprints 19. `earth2_get_bazaar_blueprints` - Buy blueprints 20. `earth2_get_balance_transactions` - Transactions 21. `earth2_get_ongoing_trades` - Active trades 22. `earth2_get_players_leaderboard` - Top players 23. `earth2_get_player_countries_leaderboard` - By country 24. `earth2_get_player_continents_leaderboard` - By continent 25. `earth2_get_essence_token_info` - ESS token 26. `earth2_get_ess_usd_rate` - ESS/USD rate 27. `earth2_get_crypto_payouts` - Crypto payouts 28. `earth2_get_quests` - Available quests 29. `earth2_get_my_quests` - Your quests 30. `earth2_get_tile_prices` - Tile prices 31. `earth2_get_territory_releases` - Territory info **NEW!** 32. `earth2_get_crafting_recipes` - Crafting data **NEW!** 33. `earth2_get_media_platforms` - Social links **NEW!** 34. `earth2_get_landing_metrics` - Platform metrics **NEW!** ## 🎉 Achievement Unlocked! **The Earth2 MCP Server now has COMPLETE coverage of the Earth2 API!** - Every endpoint from the API log is implemented - All major features are accessible via MCP tools - Both user and platform credentials are supported - Auto-refresh keeps credentials fresh - Beautiful translucent UI on Earthie platform ## 📝 Next Steps 1. ✅ Update package.json to v1.3.0 2. ✅ Commit and publish to npm 3. ✅ Update documentation 4. ✅ Test all new endpoints 5. ✅ Celebrate! 🎊 --- **Built with ❤️ for the Earth2 and Earthie communities**