sciverse

Sciverse Agent Tools

English | 简体中文

Sciverse Agent Tools provides standardized tool schemas and SDKs that expose the Sciverse Open Platform academic retrieval capabilities to LLM agents.

With these tools, you can easily empower your AI agents to search for academic papers, perform natural language semantic retrieval (RAG), and fetch original literature contents and multimodal resources (like figures and tables).

Tool	Use case
list_catalog	Discover available fields, filter operators, and enum sample values
search_papers	Structured metadata search (author / year / journal / discipline)
semantic_search	Natural-language semantic search over passages (RAG)
read_content	Fetch a byte-range slice of the source document (extend RAG context)
get_resource	Fetch figure / table image bytes referenced inside read_content Markdown

All five tools share the same Bearer-Token authentication and are exposed identically through the Python SDK, the TypeScript SDK, the MCP server, the Claude Code skill, and the ClawHub skill. The canonical schema is openapi.yaml.

Pick your integration path

Path	Best for	Setup
Skills CLI	Projects using the generic Skills CLI	npx skills add https://sciverse.space
Claude Code skill	Anyone using Claude Code / VS Code	One-line install via Plugin Marketplace (below)
MCP server	Any MCP-capable coding agent (Cursor, Codex CLI, Windsurf, …)	Add to .mcp.json — integration guides
Python / TypeScript SDK	Custom agents (OpenAI / Anthropic / LangChain / LlamaIndex / …)	pip install sciverse or npm install sciverse
CLI	Shell scripts, quick exploration, no agent loop	Comes with the Python SDK — sciverse auth login
Web well-known URL	Agent hosts that auto-discover skills via the well-known URI convention	Point your agent host at https://sciverse.space/.well-known/agent-skills/

Quickstart — Skills CLI

The easiest way to install the skill for projects supporting the Skills CLI is via the npx skills command:

npx skills add https://sciverse.space

This command automatically fetches the skill manifest and registers the tool for your project. Don't forget to configure your API token via the SCIVERSE_API_TOKEN environment variable.

Quickstart — Claude Code

claude /plugin marketplace add https://github.com/opendatalab/Sciverse-Agent-Tools
claude /plugin install sciverse

The skill depends on sciverse-mcp-server; install it once:

npm install -g sciverse-mcp-server
export SCIVERSE_API_TOKEN=sv-...     # get one from https://sciverse.space

Or declare the MCP server per-project — see skill-claude-code/SKILL.md.

Quickstart — other MCP-capable agents

Drop this snippet into your agent's MCP config (.mcp.json for Claude Code / Cursor, ~/.codex/config.toml for Codex CLI, etc.):

{
  "mcpServers": {
    "sciverse": {
      "command": "npx",
      "args": ["-y", "sciverse-mcp-server"],
      "env": { "SCIVERSE_API_TOKEN": "${SCIVERSE_API_TOKEN}" }
    }
  }
}

Per-agent step-by-step guides:

Agent	Guide
Claude Code	docs/integrations/claude-code.md
Cursor	docs/integrations/cursor.md
Codex CLI	docs/integrations/codex-cli.md
Windsurf	docs/integrations/windsurf.md

Quickstart — agent host via well-known URL

For agent hosts that auto-discover skills via the well-known URI convention, Sciverse serves the skill bundle at:

https://sciverse.space/.well-known/agent-skills/index.json

The endpoint returns a manifest listing the sciverse skill and its files (SKILL.md, references, agent adapter configs, runnable scripts). Hosts that follow the convention fetch the manifest, then materialise the skill locally for the model to invoke.

Use this channel when:

• Your agent host already supports .well-known/agent-skills/ discovery
• You want the latest skill version automatically (no version pinning on the consumer side)
• You don't want to clone a git repo just to obtain the skill

For host-specific install commands (Claude Code, MCP, OpenClaw, ClawHub), see the other Quickstart sections above.

Quickstart — SDK

1. Get a Bearer token

Sign in to the Sciverse Developer Console and create an API token.

2. Install the SDK

The official and correct package name for both pip and npm is sciverse.

# Python
pip install sciverse

# TypeScript / Node.js
npm install sciverse

3. Configure credentials (any one of the three)