Can I use Semantic Scholar as a CLI?

Yes. KosmoKrator exposes a Semantic Scholar CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Semantic Scholar through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Semantic Scholar tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Semantic Scholar credentials stored?

Semantic Scholar credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Semantic Scholar MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

data

Semantic Scholar CLI for AI Agents

Use the Semantic Scholar CLI from KosmoKrator to call Semantic Scholar tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Semantic Scholar CLI Setup

Semantic Scholar can be configured headlessly with `kosmokrator integrations:configure semantic-scholar`.

Install, configure, and verify

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure semantic-scholar --set api_key="$SEMANTIC_SCHOLAR_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor semantic-scholar --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`api_key`	`SEMANTIC_SCHOLAR_API_KEY`	Secret `secret`	yes	API Key

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call

kosmo integrations:call semantic-scholar.semantic_scholar_search_papers '{}' --json

Provider shortcut

kosmo integrations:semantic-scholar semantic_scholar_search_papers '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands

kosmo integrations:docs semantic-scholar --json
kosmo integrations:docs semantic-scholar.semantic_scholar_search_papers --json
kosmo integrations:schema semantic-scholar.semantic_scholar_search_papers --json
kosmo integrations:search "Semantic Scholar" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`semantic-scholar.semantic_scholar_search_papers`

Search papers by relevance.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_search_papers '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_search_papers '{}' --json

`semantic-scholar.semantic_scholar_bulk_search_papers`

Bulk search papers with token paging.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_bulk_search_papers '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_bulk_search_papers '{}' --json

`semantic-scholar.semantic_scholar_title_search_papers`

Search for papers by title.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_title_search_papers '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_title_search_papers '{}' --json

`semantic-scholar.semantic_scholar_autocomplete_papers`

Suggest paper query completions.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_autocomplete_papers '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_autocomplete_papers '{}' --json

`semantic-scholar.semantic_scholar_get_paper`

Get one paper by ID.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_get_paper '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_get_paper '{}' --json

`semantic-scholar.semantic_scholar_batch_get_papers`

Get multiple papers by ID.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_batch_get_papers '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_batch_get_papers '{}' --json

`semantic-scholar.semantic_scholar_get_paper_authors`

Get authors for a paper.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_get_paper_authors '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_get_paper_authors '{}' --json

`semantic-scholar.semantic_scholar_get_paper_citations`

Get papers that cite a paper.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_get_paper_citations '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_get_paper_citations '{}' --json

`semantic-scholar.semantic_scholar_get_paper_references`

Get papers referenced by a paper.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_get_paper_references '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_get_paper_references '{}' --json

`semantic-scholar.semantic_scholar_search_authors`

Search authors by name.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_search_authors '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_search_authors '{}' --json

`semantic-scholar.semantic_scholar_get_author`

Get one author by ID.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_get_author '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_get_author '{}' --json

`semantic-scholar.semantic_scholar_batch_get_authors`

Get multiple authors by ID.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_batch_get_authors '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_batch_get_authors '{}' --json

`semantic-scholar.semantic_scholar_get_author_papers`

Get papers by an author.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_get_author_papers '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_get_author_papers '{}' --json

`semantic-scholar.semantic_scholar_search_snippets`

Search paper text snippets.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_search_snippets '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_search_snippets '{}' --json

`semantic-scholar.semantic_scholar_recommend_papers`

Recommend papers from positive and negative seeds.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_recommend_papers '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_recommend_papers '{}' --json

`semantic-scholar.semantic_scholar_recommend_for_paper`

Recommend papers for one paper.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_recommend_for_paper '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_recommend_for_paper '{}' --json

`semantic-scholar.semantic_scholar_list_dataset_releases`

List available dataset releases.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_list_dataset_releases '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_list_dataset_releases '{}' --json

`semantic-scholar.semantic_scholar_get_dataset_release`

List datasets in a release.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_get_dataset_release '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_get_dataset_release '{}' --json

`semantic-scholar.semantic_scholar_get_dataset`

Get dataset download links.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_get_dataset '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_get_dataset '{}' --json

`semantic-scholar.semantic_scholar_get_dataset_diffs`

Get incremental diff download links.

Read read

Parameters: none

Generic call

kosmo integrations:call semantic-scholar.semantic_scholar_get_dataset_diffs '{}' --json

Shortcut

kosmo integrations:semantic-scholar semantic_scholar_get_dataset_diffs '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

semantic-scholar.semantic_scholar_search_papers 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_search_papers --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_bulk_search_papers 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_bulk_search_papers --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_title_search_papers 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_title_search_papers --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_autocomplete_papers 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_autocomplete_papers --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_get_paper 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_get_paper --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_batch_get_papers 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_batch_get_papers --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_get_paper_authors 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_get_paper_authors --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_get_paper_citations 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_get_paper_citations --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_get_paper_references 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_get_paper_references --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_search_authors 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_search_authors --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_get_author 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_get_author --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_batch_get_authors 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_batch_get_authors --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_get_author_papers 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_get_author_papers --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_search_snippets 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_search_snippets --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_recommend_papers 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_recommend_papers --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_recommend_for_paper 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_recommend_for_paper --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_list_dataset_releases 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_list_dataset_releases --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_get_dataset_release 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_get_dataset_release --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_get_dataset 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_get_dataset --json

Parameter	Type	Required	Description
No parameters.

semantic-scholar.semantic_scholar_get_dataset_diffs 0 parameters

Schema command

kosmo integrations:schema semantic-scholar.semantic_scholar_get_dataset_diffs --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.