feat(tools): NinjaPear

tools/pyproject.toml

@@ -28,7 +28,7 @@ dependencies = [
     "python-dotenv>=1.0.0",
     "playwright>=1.40.0",
     "playwright-stealth>=1.0.5",
-    "litellm==1.81.7",  # pinned: supply chain attack in >=1.82.7 (adenhq/hive#6783)
+    "litellm==1.81.7"
     "dnspython>=2.4.0",
     "resend>=2.0.0",
     "asana>=3.2.0",

tools/src/aden_tools/credentials/__init__.py

@@ -99,6 +99,7 @@
 from .mongodb import MONGODB_CREDENTIALS
 from .n8n import N8N_CREDENTIALS
 from .news import NEWS_CREDENTIALS
+from .ninjapear import NINJAPEAR_CREDENTIALS
 from .notion import NOTION_CREDENTIALS
 from .obsidian import OBSIDIAN_CREDENTIALS
 from .pagerduty import PAGERDUTY_CREDENTIALS
@@ -183,6 +184,7 @@
     **MONGODB_CREDENTIALS,
     **N8N_CREDENTIALS,
     **NEWS_CREDENTIALS,
+    **NINJAPEAR_CREDENTIALS,
     **NOTION_CREDENTIALS,
     **OBSIDIAN_CREDENTIALS,
     **PAGERDUTY_CREDENTIALS,
@@ -275,6 +277,7 @@
     "MONGODB_CREDENTIALS",
     "N8N_CREDENTIALS",
     "NEWS_CREDENTIALS",
+    "NINJAPEAR_CREDENTIALS",
     "NOTION_CREDENTIALS",
     "OBSIDIAN_CREDENTIALS",
     "PAGERDUTY_CREDENTIALS",

tools/src/aden_tools/credentials/ninjapear.py

@@ -0,0 +1,53 @@
+"""
+NinjaPear (Nubela) tool credentials.
+
+Contains credentials for the NinjaPear API — company and people enrichment.
+API reference: https://nubela.co/docs/
+"""
+
+from .base import CredentialSpec
+
+NINJAPEAR_CREDENTIALS = {
+    "ninjapear": CredentialSpec(
+        env_var="NINJAPEAR_API_KEY",
+        tools=[
+            "ninjapear_get_person_profile",
+            "ninjapear_get_company_details",
+            "ninjapear_get_company_funding",
+            "ninjapear_get_company_updates",
+            "ninjapear_get_company_customers",
+            "ninjapear_get_company_competitors",
+            "ninjapear_get_credit_balance",
+        ],
+        required=True,
+        startup_required=False,
+        help_url="https://nubela.co/docs/",
+        description="NinjaPear API key for company and people enrichment",
+        aden_supported=False,
+        direct_api_key_supported=True,
+        api_key_instructions="""To get a NinjaPear API key:
+1. Sign up at https://nubela.co/ using a WORK email address
+   (free email providers such as Gmail, Outlook, Yahoo are not accepted)
+2. Go to your Dashboard > API section
+3. Copy your API key
+
+Note: NinjaPear uses a credit system. Credits are only consumed on HTTP 200 responses.
+- Free trial: small credit allocation (work email required to register)
+- Paid: credit packs purchased as needed
+- Credit costs per call:
+  - ninjapear_get_person_profile: 3 credits
+  - ninjapear_get_company_details: 2-5 credits
+  - ninjapear_get_company_funding: 2+ credits (1 credit per investor)
+  - ninjapear_get_company_updates: 2 credits
+  - ninjapear_get_company_customers: 1 + 2 credits/company returned
+  - ninjapear_get_company_competitors: 5 credits minimum
+  - ninjapear_get_credit_balance: FREE (0 credits)
+
+Set the environment variable:
+  export NINJAPEAR_API_KEY=your-api-key""",
+        health_check_endpoint="https://nubela.co/api/v1/meta/credit-balance",
+        health_check_method="GET",
+        credential_id="ninjapear",
+        credential_key="api_key",
+    ),
+}

tools/src/aden_tools/tools/__init__.py

@@ -92,6 +92,7 @@
 from .mongodb_tool import register_tools as register_mongodb
 from .n8n_tool import register_tools as register_n8n
 from .news_tool import register_tools as register_news
+from .ninjapear_tool import register_tools as register_ninjapear
 from .notion_tool import register_tools as register_notion
 from .obsidian_tool import register_tools as register_obsidian
 from .pagerduty_tool import register_tools as register_pagerduty
@@ -269,6 +270,7 @@ def _register_unverified(
     register_microsoft_graph(mcp, credentials=credentials)
     register_mongodb(mcp, credentials=credentials)
     register_n8n(mcp, credentials=credentials)
+    register_ninjapear(mcp, credentials=credentials)
     register_obsidian(mcp, credentials=credentials)
     register_pagerduty(mcp, credentials=credentials)
     register_pinecone(mcp, credentials=credentials)

tools/src/aden_tools/tools/ninjapear_tool/__init__.py

@@ -0,0 +1,3 @@
+from .ninjapear_tool import register_tools
+
+__all__ = ["register_tools"]