@digital-science-dsl/dimensions-analytics-mcp 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -1,9 +1,7 @@
 # Changelog
 
-## 1.0.1
+## 1.0.3
 
-- Install docs: `npx` examples use latest npm package by default (optional `@x.y.z` pin)
-
-## 1.0.0
-
-Initial public release of Dimensions Analytics MCP.
+- README intro, prerequisites, and API key link to account settings
+- Move hosted coming-soon notice to INSTALLATION
+- REFERENCE note for troubleshooting; clearer field aliases description

package/README.md

@@ -1,148 +1,5 @@
-# Dimensions Analytics MCP
+# @digital-science-dsl/dimensions-analytics-mcp
 
-Model Context Protocol (MCP) server for the Dimensions Analytics API — enables AI assistants to search and analyze linked research data with the Dimensions DSL.
+Dimensions Analytics MCP server for the Dimensions DSL.
 
-**Transport:** stdio (`dimensions-analytics-mcp`) for local use. A hosted remote option (URL + Bearer token) is **coming soon** — see [Installation — Hosted Dimensions Analytics MCP](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/INSTALLATION.md#hosted-dimensions-analytics-mcp-coming-soon).
-
-## What It Does
-
-Dimensions Analytics MCP provides access to Dimensions, the world's largest linked research information database with over 140M publications, grants, patents, clinical trials, and more. It enables Claude and other MCP-compatible AI assistants to search and analyze research data.
-
-## Available Tools
-
-### Search Tools
-
-| Tool | Description |
-| ---- | ----------- |
-| `search_publications` | Search research articles, preprints, and books with citation metrics |
-| `search_grants` | Search research grants and funding awards |
-| `search_researchers` | Search researcher profiles with publication counts and affiliations |
-| `search_patents` | Search patents with assignee and filing information |
-| `search_clinical_trials` | Search clinical trials by phase, condition, or status |
-| `search_datasets` | Search research datasets and repositories |
-| `search_policy_documents` | Search policy briefs and government documents |
-| `search_organizations` | Search universities, research institutes, and companies |
-| `fetch_search_pages` | Paginated / batch search (page, aggregate, JSONL/CSV file export) — **local stdio only** |
-
-### Lookup Tools
-
-| Tool | Description |
-| ---- | ----------- |
-| `get_by_doi` | Retrieve publication by DOI |
-| `get_by_pmid` | Retrieve publication by PubMed ID |
-| `get_by_id` | Retrieve any entity by Dimensions ID |
-
-### Analytics & Trend Tools
-
-| Tool | Description |
-| ---- | ----------- |
-| `aggregate_query` | Numeric aggregation (sum/avg/count) over any entity with grouping |
-| `facet_query` | Facet counts for top values of any field |
-| `citation_trend` | Citation counts over time for a topic or entity |
-| `funding_trend` | Funding awarded over time for a topic or entity |
-
-### Entity Resolution Tools
-
-| Tool | Description |
-| ---- | ----------- |
-| `extract_affiliations` | Resolve organization affiliations to GRID/ROR identifiers |
-| `extract_grants` | Resolve grant numbers to full grant records |
-| `execute_dsl` | Execute raw Dimensions DSL queries (classify, extract concepts, similarity, KWQ, and more) |
-
-### Schema Tools
-
-| Tool | Description |
-| ---- | ----------- |
-| `describe_schema` | Summarize live describe schema (sources, entities, limits) |
-| `refresh_schema` | Reload describe schema from the API |
-
-## Quick Start
-
-**Easiest** — one-line install (no clone required):
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/digital-science/dimensions-analytics-mcp/main/scripts/install.sh | bash
-```
-
-```powershell
-irm https://raw.githubusercontent.com/digital-science/dimensions-analytics-mcp/main/scripts/install.ps1 | iex
-```
-
-See [Installation](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/INSTALLATION.md) for manual setup.
-
-### Build from source (developers)
-
-```bash
-pnpm install
-pnpm run build
-export DIMENSIONS_API_KEY=your-key
-node apps/mcp/dist/main.js          # stdio
-```
-
-### Claude Desktop (stdio)
-
-```json
-{
-  "mcpServers": {
-    "dimensions": {
-      "command": "node",
-      "args": ["/path/to/dimensions-analytics-mcp/apps/mcp/dist/main.js"],
-      "env": {
-        "DIMENSIONS_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-
-### Hosted remote MCP (coming soon)
-
-A hosted Dimensions Analytics MCP endpoint (URL + Bearer token, no local install) is **not available yet**. We will announce it in the near future. See [Installation — Hosted Dimensions Analytics MCP](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/INSTALLATION.md#hosted-dimensions-analytics-mcp-coming-soon).
-
-## Examples and usage
-
-**[Usage guide](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/USAGE.md)** — workflows, JSON tool examples, DSL snippets, and natural-language prompts.
-
-Quick prompt examples:
-
-```text
-Find the top 10 most-cited publications about CRISPR from the last 5 years
-```
-
-```text
-Facet journals for "quantum computing" publications since 2020
-```
-
-## Documentation
-
-**This package**
-
-- [Usage guide](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/USAGE.md) — **start here** for examples
-- [Deployment](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/DEPLOYMENT.md) — local stdio setup; hosted option (coming soon)
-- [Configuration](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/CONFIGURATION.md) — env vars
-- [MCP field aliases](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/MCP_FIELD_ALIASES.md) — alias reference for tool users
-
-**Repository** ([dimensions-analytics-mcp](https://github.com/digital-science/dimensions-analytics-mcp))
-
-- [Root README](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/README.md)
-- [Installation](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/INSTALLATION.md)
-
-**External**
-
-- [Dimensions API Docs](https://docs.dimensions.ai/)
-- [Model Context Protocol spec](https://modelcontextprotocol.io/)
-
-## Development
-
-```bash
-pnpm install   # from repo root
-pnpm run build
-
-pnpm run test              # unit + mock hosted e2e
-pnpm run integration:smoke # live stdio smoke (DIMENSIONS_API_KEY)
-pnpm run typecheck
-```
-
-## License
-
-MIT
+**Documentation:** [github.com/digital-science/dimensions-analytics-mcp](https://github.com/digital-science/dimensions-analytics-mcp) — [Installation](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/INSTALLATION.md), [Usage](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/USAGE.md), [Reference](https://github.com/digital-science/dimensions-analytics-mcp/blob/main/docs/REFERENCE.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digital-science-dsl/dimensions-analytics-mcp",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Dimensions Analytics MCP server for Dimensions DSL querying",
   "type": "module",
   "main": "./dist/index.js",