Skip to content

Project Server ​

The project server (servers/research/) provides structured project management with support for different project types, source tracking, APA citation generation, bibliography output, and data backend registration.

Renamed from Research Server

This server was previously called "crow-research." The server name is now crow-projects, and the factory function is createProjectServer (the old createResearchServer name still works as a backward-compatible alias). The gateway mounts at /projects/mcp (primary) and /research/mcp (legacy alias).

Project Types ​

Projects have a type field that determines their purpose:

TypeDescription
researchTraditional research projects with sources, citations, and bibliography (default)
data_connectorProjects that connect to external data through registered backends

The type is set when creating a project and determines which tools and workflows are relevant.

Tools ​

crow_create_project ​

Create a new project.

ParameterTypeRequiredDescription
namestringYesProject name
descriptionstringNoProject description and goals
tagsstringNoComma-separated tags
typestringNoProject type: research (default) or data_connector

crow_list_projects ​

List all projects with optional status filter.

ParameterTypeRequiredDescription
statusstringNoFilter by status

crow_update_project ​

Update a project's name, description, status, or tags.

ParameterTypeRequiredDescription
idnumberYesProject ID
namestringNoNew name
descriptionstringNoNew description
statusstringNoNew status (active, paused, completed, archived)
tagsstringNoNew tags

crow_add_source ​

Add a source to a project. Automatically generates an APA citation if none is provided. Most commonly used with research type projects.

ParameterTypeRequiredDescription
titlestringYesSource title
source_typestringYesType (see list below)
project_idnumberNoAssociate with a project
urlstringNoURL where the source was found
authorsstringNoAuthor(s) in "Last, F. M." format
publication_datestringNoPublication date (YYYY-MM-DD or YYYY)
publisherstringNoPublisher or website name
doistringNoDOI (for academic papers)
isbnstringNoISBN (for books)
abstractstringNoAbstract or brief description
content_summarystringNoSummary of key points and findings
full_textstringNoFull text content if available
citation_apastringNoManual APA citation (auto-generated if omitted)
retrieval_methodstringNoHow the source was obtained
tagsstringNoComma-separated tags
relevance_scorenumberNoHow relevant to the project, 1-10 (default: 5)

Source types: web_article, academic_paper, book, interview, web_search, web_scrape, api_data, document, video, podcast, social_media, government_doc, dataset, other

crow_search_sources ​

Search sources using full-text search.

ParameterTypeRequiredDescription
querystringYesSearch query
source_typestringNoFilter by type
project_idnumberNoFilter by project
limitnumberNoMax results

crow_get_source ​

Get full details of a specific source.

ParameterTypeRequiredDescription
source_idnumberYesSource ID

crow_verify_source ​

Mark a source's verification status.

ParameterTypeRequiredDescription
source_idnumberYesSource ID
verifiedbooleanYesVerification status
verification_notesstringNoNotes about verification

crow_list_sources ​

List sources with optional filtering.

ParameterTypeRequiredDescription
project_idnumberNoFilter by project
source_typestringNoFilter by type
verifiedbooleanNoFilter by verification status
limitnumberNoMax results

crow_add_note ​

Add a note, optionally linked to a project or source.

ParameterTypeRequiredDescription
contentstringYesNote content
note_typestringNoType: note, quote, summary, analysis, question, insight (default: note)
project_idnumberNoAssociated project
source_idnumberNoAssociated source
titlestringNoNote title
tagsstringNoComma-separated tags

crow_search_notes ​

Search notes by content.

ParameterTypeRequiredDescription
querystringYesSearch terms
project_idnumberNoFilter by project
note_typestringNoFilter by type (note, quote, summary, analysis, question, insight)
limitnumberNoMax results (default: 10)

crow_generate_bibliography ​

Generate a formatted APA bibliography for a project or filtered set of sources.

ParameterTypeRequiredDescription
project_idnumberNoGenerate bibliography for this project
tagstringNoFilter by tag
verified_onlybooleanNoOnly include verified sources (default: false)

crow_project_stats ​

Get statistics about projects and the research pipeline. No parameters.

Data Backend Tools ​

These tools manage external data connections for data_connector type projects.

crow_register_backend ​

Register an external MCP server as a data backend.

ParameterTypeRequiredDescription
namestringYesBackend name
server_urlstringYesMCP server URL
descriptionstringNoWhat data this backend provides

crow_list_backends ​

List all registered data backends. No parameters.

crow_remove_backend ​

Remove a registered data backend.

ParameterTypeRequiredDescription
backend_idnumberYesBackend ID

crow_backend_schema ​

Get the schema (available tools) from a registered backend.

ParameterTypeRequiredDescription
backend_idnumberYesBackend ID

Resources ​

research://projects ​

Returns the list of all projects.

APA Citation Generation ​

The server automatically generates APA citations when adding sources. The citation format varies by source type:

  • Academic papers: Author (Year). Title. Publisher. DOI/URL
  • Books: Author (Year). *Title*. Publisher.
  • Web articles: Author (Year). Title. Site Name. URL
  • Other types: Standard APA format with available fields

Released under the MIT License.