# Microgram: openalex-org-search-works

`station__algovigilance__microgram-openalex-org-search-works` · native (always callable) · domain `algovigilance` · pv-relevance `pv-core`

Search the OpenAlex works graph by free-text query. Returns each work with cited_by_count (raw citations), fwci (field-weighted citation impact; 1.0 = field average), publication_year, open_access.is_oa, and authorships. Primary use: rank literature hits by influence before triaging for evidence review.

## Agent metadata

- `idempotent`: true
- `read_only`: true
- `expected_latency_ms`: unknown (not yet contract-tested)
- `cost_tokens_estimate`: unknown

## Input schema

- `search` *string* (required) — Free-text query. Matches title, abstract, fulltext when available. Example: 'metformin lactic acidosis'.
- `per_page` *number* — Results per page (1-200, default 25).
- `filter` *string* — Optional OpenAlex filter string. Examples: 'publication_year:2020-2025', 'type:article', 'is_oa:true', 'cited_by_count:>50'. Comma-separated for AND.

## Example call

```json
POST /api/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "station__algovigilance__microgram-openalex-org-search-works",
    "arguments": {
      "search": ""
    }
  }
}
```

## Related

- [/tools](/tools) — all 7718 tools
- [/tools/algovigilance__microgram-openalex-org-search-works](/tools/algovigilance__microgram-openalex-org-search-works) — HTML page
- [/tools/algovigilance__microgram-openalex-org-search-works/json](/tools/algovigilance__microgram-openalex-org-search-works/json) — JSON form (agent-friendly)
- [/api/mcp](/api/mcp) — endpoint
- [/AGENTS.md](/AGENTS.md) — agent guide