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.