graphlit-mcp-server
Server Configuration
Describes the environment variables required to run the server.
Name | Required | Description | Default |
---|---|---|---|
JIRA_EMAIL | No | Your Jira email for Jira data connector integration | |
JIRA_TOKEN | No | Your Jira token for Jira data connector integration | |
LINEAR_API_KEY | No | Your Linear API key for Linear data connector integration | |
NOTION_API_KEY | No | Your Notion API key for Notion data connector integration | |
SLACK_BOT_TOKEN | No | Your Slack bot token for Slack data connector integration | |
DISCORD_BOT_TOKEN | No | Your Discord bot token for Discord data connector integration | |
NOTION_DATABASE_ID | No | Your Notion database ID for Notion data connector integration | |
GRAPHLIT_JWT_SECRET | Yes | Your JWT secret for signing the JWT token found in the API settings dashboard | |
GOOGLE_EMAIL_CLIENT_ID | No | Your Google client ID for Google Mail data connector integration | |
GRAPHLIT_ENVIRONMENT_ID | Yes | Your Graphlit environment ID found in the API settings dashboard | |
GRAPHLIT_ORGANIZATION_ID | Yes | Your Graphlit organization ID found in the API settings dashboard | |
GOOGLE_EMAIL_CLIENT_SECRET | No | Your Google client secret for Google Mail data connector integration | |
GOOGLE_EMAIL_REFRESH_TOKEN | No | Your Google refresh token for Google Mail data connector integration | |
GITHUB_PERSONAL_ACCESS_TOKEN | No | Your GitHub personal access token for GitHub data connector integration |
Schema
Prompts
Interactive templates invoked by user choice
Name | Description |
---|---|
No prompts |
Resources
Contextual data attached and managed by the client
Name | Description |
---|---|
No resources |
Tools
Functions exposed to the LLM to take actions
Name | Description |
---|---|
retrieveSources | Retrieve relevant content sources from Graphlit knowledge base. Do not use for retrieving content by content identifier - retrieve content resource instead, with URI 'contents://{id}'. Accepts a search prompt, optional recency filter (defaults to all time), and optional content type and file type filters. Also accepts optional feed and collection identifiers to filter content by. Prompt should be optimized for vector search, via text embeddings. Rewrite prompt as appropriate for higher relevance to search results. Returns the ranked content sources, including their content resource URI to retrieve the complete Markdown text. |
extractText | Extracts JSON data from text using LLM. Accepts text to be extracted, and JSON schema which describes the data which will be extracted. JSON schema needs be of type 'object' and include 'properties' and 'required' fields. Optionally accepts text prompt which is provided to LLM to guide data extraction. Defaults to 'Extract data using the tools provided'. Returns extracted JSON from text. |
createCollection | Create a collection. Accepts a collection name, and optional list of content identifiers to add to collection. Returns the collection identifier |
addContentsToCollection | Add contents to a collection. Accepts a collection identifier and a list of content identifiers to add to collection. Returns the collection identifier. |
removeContentsFromCollection | Remove contents from collection. Accepts a collection identifier and a list of content identifiers to remove from collection. Returns the collection identifier. |
deleteCollection | Delete a collection. Does not delete the content in the collection. Accepts a collection identifier. Returns the collection identifier and collection state, i.e. Deleted. |
deleteFeed | Delete a feed and all of its ingested content. Accepts a feed identifier which was returned from one of the ingestion tools, like ingestGoogleDriveFiles. Content deletion will happen asynchronously. Returns the feed identifier and feed state, i.e. Deleted. |
deleteContent | Delete content. Accepts a content identifier. Returns the content identifier and content state, i.e. Deleted. |
deleteContents | Deletes contents from Graphlit knowledge base. Accepts optional content type and file type filters to limit the contents which will be deleted. Also accepts optional limit of how many contents to delete, defaults to 1000. Returns the content identifiers and content state, i.e. Deleted. |
deleteFeeds | Deletes feeds from Graphlit knowledge base. Accepts optional feed type filter to limit the feeds which will be deleted. Also accepts optional limit of how many feeds to delete, defaults to 100. Returns the feed identifiers and feed state, i.e. Deleted. |
isContentDone | Check if content has completed asynchronous ingestion. Accepts a content identifier which was returned from one of the non-feed ingestion tools, like ingestUrl. Returns whether the content is done or not. |
isFeedDone | Check if an asynchronous feed has completed ingesting all the available content. Accepts a feed identifier which was returned from one of the ingestion tools, like ingestGoogleDriveFiles. Returns whether the feed is done or not. |
listMicrosoftTeamsTeams | Lists available Microsoft Teams teams. Returns a list of Microsoft Teams teams, where the team identifier can be used with listMicrosoftTeamsChannels to enumerate Microsoft Teams channels. |
listMicrosoftTeamsChannels | Lists available Microsoft Teams channels. Returns a list of Microsoft Teams channels, where the channel identifier can be used with ingestMicrosoftTeamsMessages to ingest messages into Graphlit knowledge base. |
listSlackChannels | Lists available Slack channels. Returns a list of Slack channels, where the channel name can be used with ingestSlackMessages to ingest messages into Graphlit knowledge base. |
listSharePointLibraries | Lists available SharePoint libraries. Returns a list of SharePoint libraries, where the selected libraryId can be used with listSharePointFolders to enumerate SharePoint folders in a library. |
listSharePointFolders | Lists available SharePoint folders. Returns a list of SharePoint folders, which can be used with ingestSharePointFiles to ingest files into Graphlit knowledge base. |
ingestSharePointFiles | Ingests files from SharePoint library into Graphlit knowledge base. Accepts a SharePoint libraryId and an optional folderId to ingest files from a specific SharePoint folder. Libraries can be enumerated with listSharePointLibraries and library folders with listSharePointFolders. Accepts an optional read limit for the number of files to ingest. Executes asynchronously and returns the feed identifier. |
ingestOneDriveFiles | Ingests files from OneDrive folder into Graphlit knowledge base. Accepts an optional read limit for the number of files to ingest. Executes asynchronously and returns the feed identifier. |
ingestGoogleDriveFiles | Ingests files from Google Drive folder into Graphlit knowledge base. Accepts an optional read limit for the number of files to ingest. Executes asynchronously and returns the feed identifier. |
ingestDropboxFiles | Ingests files from Dropbox folder into Graphlit knowledge base. Accepts optional relative path to Dropbox folder (i.e. /Pictures), and an optional read limit for the number of files to ingest. If no path provided, ingests files from root Dropbox folder. Executes asynchronously and returns the feed identifier. |
ingestBoxFiles | Ingests files from Box folder into Graphlit knowledge base. Accepts optional Box folder identifier, and an optional read limit for the number of files to ingest. If no folder identifier provided, ingests files from root Box folder (i.e. "0"). Folder identifier can be inferred from Box URL. https://app.box.com/folder/123456 -> folder identifier is "123456". Executes asynchronously and returns the feed identifier. |
ingestGitHubFiles | Ingests files from GitHub repository into Graphlit knowledge base. Accepts GitHub repository owner and repository name and an optional read limit for the number of files to ingest. For example, for GitHub repository (https://github.com/openai/tiktoken), 'openai' is the repository owner, and 'tiktoken' is the repository name. Executes asynchronously and returns the feed identifier. |
ingestNotionPages | Ingests pages from Notion database into Graphlit knowledge base. Accepts an optional read limit for the number of messages to ingest. Executes asynchronously and returns the feed identifier. |
ingestMicrosoftTeamsMessages | Ingests messages from Microsoft Teams channel into Graphlit knowledge base. Accepts Microsoft Teams team identifier and channel identifier, and an optional read limit for the number of messages to ingest. Executes asynchronously and returns the feed identifier. |
ingestSlackMessages | Ingests messages from Slack channel into Graphlit knowledge base. Accepts Slack channel name and an optional read limit for the number of messages to ingest. Executes asynchronously and returns the feed identifier. |
ingestDiscordMessages | Ingests messages from Discord channel into Graphlit knowledge base. Accepts Discord channel name and an optional read limit for the number of messages to ingest. Executes asynchronously and returns the feed identifier. |
ingestRedditPosts | Ingests posts from Reddit subreddit into Graphlit knowledge base. Accepts a subreddit name and an optional read limit for the number of posts to ingest. Executes asynchronously and returns the feed identifier. |
ingestGoogleEmail | Ingests emails from Google Email account into Graphlit knowledge base. Accepts an optional read limit for the number of emails to ingest. Executes asynchronously and returns the feed identifier. |
ingestMicrosoftEmail | Ingests emails from Microsoft Email account into Graphlit knowledge base. Accepts an optional read limit for the number of emails to ingest. Executes asynchronously and returns the feed identifier. |
ingestLinearIssues | Ingests issues from Linear project into Graphlit knowledge base. Accepts Linear project name and an optional read limit for the number of issues to ingest. Executes asynchronously and returns the feed identifier. |
ingestGitHubIssues | Ingests issues from GitHub repository into Graphlit knowledge base. Accepts GitHub repository owner and repository name and an optional read limit for the number of issues to ingest. For example, for GitHub repository (https://github.com/openai/tiktoken), 'openai' is the repository owner, and 'tiktoken' is the repository name. Executes asynchronously and returns the feed identifier. |
ingestJiraIssues | Ingests issues from Atlassian Jira repository into Graphlit knowledge base. Accepts Atlassian Jira server URL and project name, and an optional read limit for the number of issues to ingest. Executes asynchronously and returns the feed identifier. |
webCrawl | Crawls web pages from web site into Graphlit knowledge base. Accepts a URL and an optional read limit for the number of pages to crawl. Uses sitemap.xml to discover pages to be crawled from website. Executes asynchronously and returns the feed identifier. |
webMap | Enumerates the web pages at or beneath the provided URL using web sitemap. Does not ingest web pages into Graphlit knowledge base. Accepts web page URL as string. Returns list of mapped URIs from web site. |
webSearch | Performs web search based on search query. Format the search query as what would be entered into a Google search. Prefer calling this tool over using 'curl' directly for any web search. Does not ingest pages into Graphlit knowledge base. Accepts search query as string, and optional search service type. Can search for web pages, podcasts, videos, images, news, or shopping. Search service types: Tavily, Exa. Defaults to Tavily. Returns URL, title and relevant Markdown text from resulting web pages. |
ingestRSS | Ingests posts from RSS feed into Graphlit knowledge base. For podcast RSS feeds, audio will be downloaded, transcribed and ingested into Graphlit knowledge base. Accepts RSS URL and an optional read limit for the number of posts to read. Executes asynchronously and returns the feed identifier. |
ingestUrl | Ingests content from URL into Graphlit knowledge base. Can scrape web pages, and can ingest individual Word documents, PDFs, audio recordings, videos, images, or any other unstructured data. Executes asynchronously and returns the content identifier. |
ingestText | Ingests text as content into Graphlit knowledge base. Accepts a name for the content object, the text itself, and an optional text type (Plain, Markdown, Html). Defaults to Markdown text type. Can use for storing long-term textual memories or the output from LLM or other tools as content resources, which can be later searched or retrieved. Executes synchronously and returns the content identifier. |
ingestFile | Ingests local file into Graphlit knowledge base. Accepts the path to the file in the local filesystem. Executes asynchronously and returns the content identifier. |
screenshotPage | Screenshots web page from URL. Executes asynchronously and returns the content identifier. |
describeImage | Prompts vision LLM and returns completion. Does not ingest image into Graphlit knowledge base. Accepts image URL as string. Returns Markdown text from LLM completion. |
describeContent | Prompts vision LLM and returns description of image content. Accepts content identifier as string, and optional prompt for image description. Returns Markdown text from LLM completion. |