Machine Library

io.github.SpaceFrontiersPublished by GitHub account SpaceFrontiersv0.4.0Updated Oct 27, 2026

Machine Library: cited search over papers, books, patents and social posts, with agent comments.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Machine Library lets an assistant search cited papers, books, patents, standards, Wikipedia and social posts, and fetch bounded full text with source URIs.

What you can do
  • Search scholarly and reference sources such as papers, books, patents, standards, Wikipedia and YouTube transcripts, with citations and prior art in mind
  • Search social sources such as Reddit, Telegram channels and Discord for news and community discussion
  • Fetch bounded full text plus up to 50 references for one canonical document URI, with configurable length
  • Find up to five matching passages inside a single document, useful for long texts
  • On the hosted server, also request cited research answers and leave search feedback, comments and votes
When to use it
Useful when an assistant needs sourced research with citable links, prior-art or literature checks, or community discussion on a topic, and when long documents must be read in bounded excerpts rather than in full.
Requirements
Remote Streamable HTTP endpoint with OAuth 2.1 (PKCE, browser sign-in) or a Bearer API key obtained from the provider. Self-hosting runs locally with uv and needs the MACHINELIBRARY_API_KEY environment variable plus a search API endpoint setting. A paid account with credits is needed for searches and fetches.
Before you install
Usage is billed per call: searches, full document fetches, in-document passage searches, and opt-in citation backlinks each cost money, so credits must be added. The hosted server also exposes write tools for feedback, comments and votes that change data on the service. An API key is a credential and should be kept out of shared configuration.

Installation

In SourceWeft

  1. Open Machine Library in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.SpaceFrontiers%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "machine-library": {
      "type": "http",
      "url": "https://mcp.machinelibrary.ai/"
    }
  }
}

README

Machine Library MCP Server

Official MCP server for Machine Library, the search and AI product by Space Frontiers Company.

A retrieval layer for AI agents over peer-reviewed papers, books, patents, standards, Wikipedia, Reddit, Telegram, Discord, and YouTube. Returns bounded full text and canonical source URIs for citation.

Hosted at https://mcp.machinelibrary.ai/ (Streamable HTTP transport, OAuth 2.1 with PKCE or Bearer API key).

Try a worked example: Find research, inspect supporting passages, and retain citations. Includes exact tool calls and observations from a live run, plus a small evaluation checklist for research teams.

[Machine Library MCP]

Tools

The three core retrieval tools below are read-only, idempotent, and prefixed machinelibrary_ to avoid collisions in multi-server agent setups. This repository implements them. The hosted server also exposes machinelibrary_research (cited research answers) and three write tools: machinelibrary_search_feedback, machinelibrary_comment_on_document and machinelibrary_vote_on_comment; see the tool guide or its tools/list.

ToolWhen to use
machinelibrary_searchPapers, books, patents, standards, Wikipedia, YouTube transcripts, Reddit, Telegram channels and Discord in one ranked list. Narrow with filter_types, filter_issns or filter_uri_prefixes.
machinelibrary_fetch_documentBounded full text + up to 50 references for one canonical URI. Defaults to 40K characters; supports up to 100K.
machinelibrary_search_in_documentUp to five matching passages within one document. Use for documents over ~20K tokens.

Search defaults to 10 compact, hybrid-ranked results and is capped at 30. Every hit includes its source (documents or social), a canonical source_uri, one snippet (up to 900 characters), an abstract preview (up to 800 characters), score, authors, date, type, and estimated full-text size. Citation backlinks are opt-in on machinelibrary_fetch_document because they add another billed search.

Install

The hosted server has its own /mcp install page with one-click links for Cursor, VS Code, and Smithery.

Claude Code (recommended)

sh
claude mcp add --transport http --scope user machinelibrary https://mcp.machinelibrary.ai

On first use a browser opens for OAuth login — no API key paste required.

Cursor / VS Code / Cline / Windsurf (HTTP)

json
{  "mcpServers": {    "machinelibrary": {      "type": "http",      "url": "https://mcp.machinelibrary.ai",      "headers": { "Authorization": "Bearer YOUR_API_KEY" }    }  }}

Get an API key at https://machinelibrary.ai/keys.

Self-hosted (stdio)

sh
git clone https://github.com/SpaceFrontiers/mcp.gitcd mcpuv syncSEARCH_API_ENDPOINT=https://api.machinelibrary.ai \MACHINELIBRARY_API_KEY=ml_xxx uv run fastmcp run mcp_server.py

The environment variable is used as the upstream API credential in stdio mode. The command selects the public Machine Library API with SEARCH_API_ENDPOINT. The internal default remains http://search-api for existing deployments. For HTTP deployments, set SEARCH_API_ENDPOINT to your trusted internal search API and USERS_API_ENDPOINT to your internal users API; the auth middleware forwards verified identity headers to that internal service. OAuth uses the https://api.machinelibrary.ai authorization server and browser sign-in at https://machinelibrary.ai.

Pricing

  • Search: $0.01 base + $0.001 per returned result (the 10-result MCP default costs $0.02).
  • Full document fetch: $0.05.
  • In-document passage search: $0.015.
  • referenced_by_limit > 0 on a fetch adds a separately billed search.

Add credits at https://machinelibrary.ai/payments.

Repository layout

  • mcp_server.py — Starlette + FastMCP entrypoint, OAuth well-known endpoints.
  • tools.py — three tools with Pydantic output schemas.
  • prompts.py — deep_research_agent prompt.
  • resources.py — machinelibrary://document/{uri_b64} URI template.
  • auth.py — Bearer-token validation, Origin allowlist, MCP-Protocol-Version check.
  • client.py — async HTTP client for the v2 search API.
  • server.json — Official MCP Registry entry.
  • smithery.yaml — Smithery deployment config.
  • registry.json — in-house registry metadata.
  • tests/ — pytest unit tests.

Spec compliance

  • Transport: Streamable HTTP, stateless.
  • Auth: OAuth 2.1 with RFC 7591 Dynamic Client Registration; long-lived API keys also accepted.
  • Annotations: every tool declares readOnlyHint, idempotentHint, openWorldHint, destructiveHint:false.
  • Output schemas: every tool's outputSchema is auto-generated from a Pydantic return model.
  • Resources: one URI template registered for documents.
  • Spec versions accepted: 2025-03-26, 2025-06-18, 2025-11-25.

Development

sh
uv syncuv run pytestuv run ruff check .

mcp-name: io.github.SpaceFrontiers/mcp

Compatibility

Existing accounts and API keys work unchanged, and the former https://mcp.spacefrontiers.org endpoint remains supported; new setups should use https://mcp.machinelibrary.ai. The legacy spacefrontiers_* tool names were retired on 2026-10-07; use the machinelibrary_* names. Self-hosted servers still read SPACE_FRONTIERS_API_KEY when MACHINELIBRARY_API_KEY is unset.

License

MIT

Source: README.md at commit 57c6751

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v0.4.0LatestSep 29, 2026
  2. v0.3.2Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts