docs: align NeuroAPI skills with v0.1.13

Correct streaming events, status codes, and client timeouts, and document
system_prompt, output_schema, idempotency, quota headers, and MCP from
the live NeuroAPI docs.

Co-authored-by: Vlad Yashin <0xspacecreated@users.noreply.github.com>

Author: 0xspacecreated

.claude-plugin/marketplace.json

@@ -31,7 +31,7 @@
       "name": "neurobro-meme-hunting",
       "source": "./skills/neurobro-meme-hunting",
       "skills": "./",
-      "description": "Discover and risk-vet trending and newly launched memecoins through the NeuroAPI agent - scan trending DEX pools, filter by liquidity and age, and audit tokens for honeypots, rug-pull risk, and holder concentration",
+      "description": "Discover and risk-vet trending and newly launched memecoins through the NeuroAPI agent - screen tokens for scam flags, mint and freeze authority, holder concentration, and buy/sell pressure, and filter new launches by age and liquidity",
       "keywords": [
         "neurobro",
         "neuroapi",

README.md

@@ -22,7 +22,7 @@ and rate limits, and writing prompts that produce useful research.
 | Skill | What it does |
 | --- | --- |
 | [`neurobro-market-research`](skills/neurobro-market-research/) | Financial market research via the NeuroAPI agent - equity and crypto analysis, technical setups, fundamental research, macro outlooks, and multi-asset investigations. |
-| [`neurobro-meme-hunting`](skills/neurobro-meme-hunting/) | Discover and risk-vet trending and newly launched memecoins - scan trending DEX pools, filter by liquidity and age, audit for honeypots, rug-pull risk, and holder concentration. |
+| [`neurobro-meme-hunting`](skills/neurobro-meme-hunting/) | Discover and risk-vet trending and newly launched memecoins - screen for scam flags, mint and freeze authority, holder concentration, and buy/sell pressure, and filter new launches by age and liquidity. |
 | [`neurobro-trading-setup`](skills/neurobro-trading-setup/) | Build structured trade setups - entry zones, stop-loss, take-profit targets, and risk/reward ratios grounded in technical analysis and derivatives positioning. |
 | [`neurobro-catalyst-watch`](skills/neurobro-catalyst-watch/) | Build event-driven trade plans - map upcoming catalysts (earnings, FOMC and macro prints, token unlocks, launches, listings, regulatory decisions), assess what is priced in, and plan positioning around the event. |
 
@@ -47,7 +47,8 @@ Or as a Claude Code plugin:
 
 1. [Create an API key](https://neuroapi.neurobro.ai) in the NeuroAPI dashboard
    under **API Keys**. Keys look like `neuro_<random>` and are shown only once.
-2. Make sure the account has an active plan - `/agent/ask` requires one.
+2. Make sure the account has an active plan. No plan returns `403`
+   `no_active_subscription` on `/agent/ask`.
 3. Provide the key via the `NEUROAPI_API_KEY` environment variable:
 
    ```bash
@@ -58,6 +59,14 @@ Or as a Claude Code plugin:
 `.env` is git-ignored, so the real key is never committed. `.env.example` is
 the committed template and holds no secret.
 
+## MCP
+
+The same agent is available over MCP at `https://api.neurobro.ai/api/v1/mcp`
+(Streamable HTTP), tool `ask_neuroapi`. Send `X-API-Key`.
+`Authorization: Bearer` is accepted on that endpoint only. The REST API
+does not accept it. Do not put the key in the URL. See
+[the endpoint reference](skills/neurobro-market-research/references/endpoints.md#mcp).
+
 ## Repo layout
 
 ```

agents/AGENTS.md

@@ -6,11 +6,15 @@ paid public API for financial market research.
 ## What NeuroAPI is
 
 - Base URL: `https://api.neurobro.ai/api/v1`
-- Auth: `X-API-Key` header. Keys look like `neuro_<random>`. No OAuth, no
-  `Authorization: Bearer`.
+- Auth: REST calls use the `X-API-Key` header. Keys look like `neuro_<random>`.
+  No OAuth. `Authorization: Bearer` is not accepted on the REST API. It is
+  accepted only by the MCP server at `https://api.neurobro.ai/api/v1/mcp`
+  (tool `ask_neuroapi`). Do not put the key in the URL.
 - Core endpoint: `POST /agent/ask` - runs a financial research agent over a
-  natural-language `prompt` and returns an `answer`.
-- Free check: `GET /health` - verifies the key, consumes no quota.
+  natural-language `prompt` and returns an `answer`. With `output_schema`,
+  the object is on `output` and `answer` is null.
+- Free check: `GET /health` - verifies the key, consumes no quota. An active
+  subscription is still required.
 
 ## API key
 
@@ -27,8 +31,9 @@ relevant to the task:
   equity and crypto analysis, technical setups, fundamental research, macro
   outlooks, multi-asset investigations.
 - `neurobro-meme-hunting` - discover and risk-vet trending and newly launched
-  memecoins: scan DEX pools, filter by liquidity and age, audit for honeypots,
-  rug-pull risk, and holder concentration.
+  memecoins: screen for scam flags, mint and freeze authority, holder
+  concentration, and buy/sell pressure, and filter new launches by age and
+  liquidity.
 - `neurobro-trading-setup` - build structured trade setups: entry zones,
   stop-loss, take-profit targets, and risk/reward ratios from technical
   analysis and derivatives positioning.

skills/neurobro-catalyst-watch/SKILL.md

@@ -45,7 +45,10 @@ Every request goes to one endpoint:
 
 Authenticate with the `X-API-Key` header, reading the key from the
 `NEUROAPI_API_KEY` environment variable - never hardcode it. The body takes a
-`prompt` and a `mode` (`fast` | `smart` | `max`, default `smart`).
+`prompt` and a `mode` (`fast` | `smart` | `max`, default `smart`). A
+non-streaming run longer than 300 seconds returns `504` `agent_timeout`
+and is not billed, so set the client timeout above 300 seconds and prefer
+`stream: true` for `max`.
 
 ```bash
 curl -s https://api.neurobro.ai/api/v1/agent/ask \
@@ -196,7 +199,7 @@ def ask(prompt: str, mode: str = "smart") -> str:
         "https://api.neurobro.ai/api/v1/agent/ask",
         headers={"X-API-Key": os.environ["NEUROAPI_API_KEY"]},
         json={"prompt": prompt, "mode": mode},
-        timeout=90,
+        timeout=330,
     )
     res.raise_for_status()
     return res.json()["answer"]
@@ -233,6 +236,7 @@ inside the trading window.
   the plan; it reasons over expectations, positioning, and history together.
 - `max` - a watchlist-wide calendar across many assets, or a high-stakes event
   (a major earnings print, an FOMC decision) where the deepest reasoning pays.
+  Stream it (`stream: true`); a non-streaming run is stopped at 300 seconds.
 - `fast` - only for a quick "what events are coming" lookup with no analysis.
 
 ## Risk notes