{
  "schema_version": "v1",
  "name_for_model": "SciSummary",
  "name_for_human": "SciSummary Research Assistant",
  "description_for_model": "SciSummary is an AI-powered research assistant that helps researchers and students understand scientific literature through intelligent summarization and analysis. It provides tools to manage research papers, create summaries in various formats, search for new papers, and interact with scientific literature through natural language queries. The service supports multiple summarization modes (standard summaries, key points, ELI5 explanations, blog posts, podcasts, slides), customizable summary lengths, and multiple languages. All operations are scoped to the authenticated user's library.",
  "description_for_human": "Manage and summarize scientific papers with AI-powered tools. Search, analyze, and interact with your research library.",
  "auth": {
    "type": "user_http",
    "authorization_type": "bearer",
    "authorization_content_type": "application/json",
    "verification_tokens": {}
  },
  "api": {
    "type": "mcp",
    "url": "https://scisummary.com/mcp",
    "has_user_authentication": true
  },
  "logo_url": "https://scisummary.com/img/logo.webp",
  "contact_email": "support@scisummary.com",
  "legal_info_url": "https://scisummary.com/terms",
  "capabilities": {
    "paper_management": {
      "list_papers": "Retrieve and search papers in your library with filtering and pagination",
      "import_paper": "Add new research papers to your library from URLs or files",
      "get_summaries": "Access existing summaries and metadata for papers"
    },
    "summarization": {
      "create_summary": "Generate AI summaries of papers in various formats and lengths",
      "modes": [
        "summarize",
        "eli5",
        "keypoints",
        "future_research",
        "sections",
        "overview_and_keypoints",
        "blog_post",
        "podcast",
        "slides"
      ],
      "lengths": ["short", "medium", "long"],
      "languages": [
        "english",
        "spanish",
        "french",
        "german",
        "italian",
        "portuguese",
        "russian",
        "chinese",
        "japanese",
        "korean",
        "arabic",
        "hindi"
      ],
      "custom_prompts": true
    },
    "interaction": {
      "ask_question": "Ask natural language questions about specific papers",
      "library_search": "Query your entire library with semantic search",
      "find_papers": "Discover new research papers based on topics or queries"
    }
  },
  "tools": [
    {
      "name": "list-papers",
      "description": "Retrieves a list of research papers from the user's library with support for search, pagination, and sorting",
      "parameters": {
        "search": {
          "type": "string",
          "description": "Search term to filter papers by title or content",
          "required": false
        },
        "limit": {
          "type": "integer",
          "description": "Maximum number of papers to return (1-100)",
          "required": false,
          "default": 20
        },
        "offset": {
          "type": "integer",
          "description": "Number of papers to skip for pagination",
          "required": false,
          "default": 0
        },
        "sort": {
          "type": "string",
          "description": "Sort order for results",
          "enum": ["created_at_desc", "created_at_asc", "title_asc", "title_desc"],
          "required": false,
          "default": "created_at_desc"
        }
      },
      "annotations": {
        "readOnly": true,
        "idempotent": true
      }
    },
    {
      "name": "summarize-paper",
      "description": "Creates an AI-generated summary of a research paper with customizable mode, length, and language",
      "parameters": {
        "paper_uuid": {
          "type": "string",
          "description": "UUID of the paper to summarize from the user's library",
          "required": true
        },
        "mode": {
          "type": "string",
          "description": "Summarization mode",
          "enum": ["summarize", "eli5", "keypoints", "future_research", "sections", "overview_and_keypoints", "blog_post", "podcast", "slides"],
          "required": false,
          "default": "summarize"
        },
        "length": {
          "type": "string",
          "description": "Length of the summary",
          "enum": ["short", "medium", "long"],
          "required": false,
          "default": "medium"
        },
        "language": {
          "type": "string",
          "description": "Language for the summary",
          "enum": ["english", "spanish", "french", "german", "italian", "portuguese", "russian", "chinese", "japanese", "korean", "arabic", "hindi"],
          "required": false,
          "default": "english"
        },
        "area_of_focus": {
          "type": "string",
          "description": "Specific area to focus on in the summary",
          "required": false
        },
        "custom_prompt": {
          "type": "string",
          "description": "Custom prompt to guide the summarization",
          "required": false
        }
      },
      "annotations": {
        "readOnly": false,
        "idempotent": false
      }
    },
    {
      "name": "get-paper-summaries",
      "description": "Retrieves all existing summaries for a specific paper",
      "parameters": {
        "paper_uuid": {
          "type": "string",
          "description": "UUID of the paper to get summaries for",
          "required": true
        }
      },
      "annotations": {
        "readOnly": true,
        "idempotent": true
      }
    },
    {
      "name": "ask-question-to-paper",
      "description": "Ask a natural language question about a specific research paper and get an AI-generated answer",
      "parameters": {
        "paper_uuid": {
          "type": "string",
          "description": "UUID of the paper to query",
          "required": true
        },
        "question": {
          "type": "string",
          "description": "The question to ask about the paper",
          "required": true
        }
      },
      "annotations": {
        "readOnly": true,
        "idempotent": true
      }
    },
    {
      "name": "ask-entire-library",
      "description": "Query the user's entire research library with a natural language question",
      "parameters": {
        "question": {
          "type": "string",
          "description": "The question to ask across all papers in the library",
          "required": true
        },
        "limit": {
          "type": "integer",
          "description": "Maximum number of relevant papers to consider",
          "required": false,
          "default": 10
        }
      },
      "annotations": {
        "readOnly": true,
        "idempotent": true
      }
    },
    {
      "name": "find-new-papers",
      "description": "Search for new research papers based on topics, keywords, or queries",
      "parameters": {
        "query": {
          "type": "string",
          "description": "Search query for finding relevant papers",
          "required": true
        },
        "limit": {
          "type": "integer",
          "description": "Maximum number of papers to return",
          "required": false,
          "default": 10
        }
      },
      "annotations": {
        "readOnly": true,
        "idempotent": true
      }
    },
    {
      "name": "import-paper-to-library",
      "description": "Import a new research paper into the user's library from a URL or file",
      "parameters": {
        "source": {
          "type": "string",
          "description": "URL or identifier of the paper to import (e.g., DOI, arXiv ID, PubMed ID, direct URL)",
          "required": true
        },
        "title": {
          "type": "string",
          "description": "Optional title for the paper",
          "required": false
        },
        "tags": {
          "type": "array",
          "description": "Optional tags to organize the paper",
          "items": {
            "type": "string"
          },
          "required": false
        }
      },
      "annotations": {
        "readOnly": false,
        "idempotent": false
      }
    }
  ],
  "usage_guidelines": {
    "authentication": "All requests require user authentication via MCP token. Users must generate a token through the SciSummary dashboard at /mcp",
    "rate_limiting": "100 requests per minute per user",
    "best_practices": [
      "Use list-papers to discover available papers before performing operations",
      "Store paper UUIDs from list-papers results for use in other tools",
      "Use search and pagination parameters to efficiently navigate large libraries",
      "Check get-paper-summaries before creating new summaries to avoid duplicates",
      "For literature reviews, use ask-entire-library to query across multiple papers",
      "When importing papers, provide descriptive tags for better organization"
    ],
    "common_workflows": [
      {
        "name": "Summarize a paper",
        "steps": [
          "Call list-papers with search term to find the paper",
          "Use the returned paper_uuid with summarize-paper",
          "Retrieve the completed summary with get-paper-summaries"
        ]
      },
      {
        "name": "Research a topic",
        "steps": [
          "Call find-new-papers with your research topic",
          "Import relevant papers using import-paper-to-library",
          "Generate summaries with summarize-paper",
          "Ask questions with ask-entire-library for synthesis"
        ]
      },
      {
        "name": "Literature review",
        "steps": [
          "Import multiple papers on a topic",
          "Create keypoints summaries for each paper",
          "Use ask-entire-library to identify common themes",
          "Generate overview_and_keypoints summaries for key papers"
        ]
      }
    ]
  },
  "model_context_protocol": {
    "version": "0.1.0",
    "server_name": "SciSummary MCP Server",
    "transport": "streamable_http",
    "endpoint": "/mcp",
    "features": {
      "tools": true,
      "resources": true,
      "prompts": true,
      "streaming": false
    },
    "documentation": "https://scisummary.com/docs/mcp"
  },
  "metadata": {
    "version": "1.0.0",
    "created_at": "2025-01-02",
    "updated_at": "2025-01-02",
    "technology_stack": {
      "framework": "Laravel 10",
      "frontend": "Vue 3 + Inertia.js",
      "mcp_library": "laravel-mcp-server",
      "ai_provider": "OpenAI"
    },
    "supported_paper_formats": [
      "PDF",
      "arXiv",
      "PubMed",
      "DOI",
      "Direct URLs"
    ],
    "features": [
      "Multi-language summarization",
      "Custom prompt support",
      "Semantic search",
      "Citation extraction",
      "Tag-based organization",
      "Multi-paper analysis",
      "Export to multiple formats (blog posts, podcasts, slides)"
    ]
  }
}