@datalanguage/datagraphs-mcp-server

An MCP (Model Context Protocol) server that exposes the Data Graphs knowledge graph platform to AI assistants such as Claude, ChatGPT, Cursor, and other MCP-compatible clients.

Prerequisites

• Node.js 18+
• A Data Graphs project with an API key

Installation

npm install @datalanguage/datagraphs-mcp-server

Or run directly with npx:

npx @datalanguage/datagraphs-mcp-server

Configuration

Obtaining Credentials

To generate the API key, client ID, and client secret:

1. Sign in to Data Graphs and open your project.
2. Click Manage Project.
3. Go to Applications and click Add Application.
4. Once the application is created, the API key, client ID, and client secret will be displayed.

Important: The client secret is shown only once at creation time. Copy it immediately and store it somewhere secure — if lost, you will need to rotate the credentials or create a new application to obtain a new secret.

Your project ID can also be found on the project page in Data Graphs.

Environment Variables

The server reads credentials from environment variables:

Variable	Required	Description
DATAGRAPHS_PROJECT_ID	Yes	Your Data Graphs project ID
DATAGRAPHS_API_KEY	Yes	API key for authentication
DATAGRAPHS_CLIENT_ID	For GQL	OAuth client ID (required for graph_search)
DATAGRAPHS_CLIENT_SECRET	For GQL	OAuth client secret (required for graph_search)

MCP Client Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "datagraphs": {
      "command": "npx",
      "args": ["-y", "@datalanguage/datagraphs-mcp-server"],
      "env": {
        "DATAGRAPHS_PROJECT_ID": "your-project-id",
        "DATAGRAPHS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add datagraphs -- npx -y @datalanguage/datagraphs-mcp-server

Then set the required environment variables in your shell before launching Claude Code.

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "datagraphs": {
      "command": "npx",
      "args": ["-y", "@datalanguage/datagraphs-mcp-server"],
      "env": {
        "DATAGRAPHS_PROJECT_ID": "your-project-id",
        "DATAGRAPHS_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

The server provides the following tools:

list_datasets

List all datasets available in the Data Graphs project.

Parameter	Type	Description
pageSize	number	Number of results per page
pageNo	number	Page number to return

search_concepts

Search for concepts (nodes) across datasets using text queries, filters, and facets.

Parameter	Type	Description
dataset	string	Dataset ID to search (defaults to all datasets)
q	string	Text search query
filter	string	NQL filter expression
facets	string[]	Property names to return facet counts for
pageSize	number	Number of results per page (default 10)
pageNo	number	Page number to return (default 1)
sort	string	Sort order, e.g. name:asc,modified:desc
embed	string[]	Relationship properties to embed (use ["_all"] to embed all)
fields	string[]	Specific fields to return for each concept
includeDateFields	boolean	Include created and last modified dates

get_concept

Get a single concept (node) by its URN identifier.

Parameter	Type	Description
id	string	Concept URN, e.g. urn:project:Type:identifier
embed	string[]	Relationship properties to embed (use ["_all"] to embed all)
fields	string[]	Specific fields to return
includeDateFields	boolean	Include created and last modified dates

graph_search

Execute a GQL graph query against the knowledge graph. Requires DATAGRAPHS_CLIENT_ID and DATAGRAPHS_CLIENT_SECRET.

Parameter	Type	Description
query	string	GQL query, e.g. MATCH (n:Person) RETURN n LIMIT 10

search_transactions

Search the transaction/audit log for the project.

Parameter	Type	Description
filter	string	NQL filter expression
pageSize	number	Number of results per page
pageNo	number	Page number to return
sort	string	Sort order, e.g. property:asc

get_model

Get the currently active data model for the project. Takes no parameters.

Development

git clone <repo-url>
cd datagraphs-client-mcp-server
npm install
npm start

License

UNLICENSED