MAD Synapse · Web & Research
Read the web (page text, DNS, WHOIS, TLS, uptime) + research (Wikipedia, arXiv, GitHub, packages).
Should I use this
Quality & Safety
Findings (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainin package_info
- INFOTool description contains placeholder or incomplete textin hn_search
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"synapse-web": {
"url": "https://agent.maddegen.art/hub/mcp/web"
}
}
}Remote endpoints
https://agent.maddegen.art/hub/mcp/webstreamable-httpWhat it can do
Tool inventory
Tools (15)
🟢web_read(url, max_chars, include_links)
Any public URL → clean readable markdown: the article/main content without nav, ads or boilerplate, plus title, author, date, word count and links. PDFs too. Fetches the page (redirects followed, public internet only), extracts the main content with Mozilla Readability and converts it to markdown. PDFs are converted to text. Use max_chars to bound the output. JavaScript-only pages return whatever the server sends (no headless browser). When to use: For a page's content; for its metadata only use web_meta; for uptime/redirects use http_probe. Price: $0.002 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "http(s) URL"
},
"max_chars": {
"type": "integer",
"minimum": 500,
"maximum": 100000,
"default": 20000,
"description": "Truncate the returned markdown to this many characters. Range 500-100000. Default 20000."
},
"include_links": {
"type": "boolean",
"default": false,
"description": "keep hyperlinks (absolute) in the markdown and return a link list. Default false."
}
},
"required": [
"url"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"number",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"byline": {
"type": [
"string",
"null"
]
},
"site": {
"type": [
"string",
"null"
]
},
"published": {
"type": [
"string",
"null"
]
},
"lang": {
"type": [
"string",
"null"
]
},
"excerpt": {
"type": [
"string",
"null"
]
},
"words": {
"type": [
"number",
"null"
]
},
"truncated": {
"type": [
"boolean",
"null"
]
},
"markdown": {
"type": [
"string",
"null"
]
},
"extracted_with": {
"type": [
"string",
"null"
]
}
}
}🟢web_meta(url)
Everything a page says about itself: title, description, OpenGraph/Twitter card, canonical, favicon, language, RSS/Atom feeds, JSON-LD schema types, headings — and link-preview problems. Use to build link previews, check SEO/social cards, find a site's feeds or structured data. Flags missing og:image, missing description and non-absolute image URLs (common reasons a link shows up bare on X/Telegram). When to use: For title/OpenGraph/canonical; for the article text use web_read. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Absolute http(s) URL of the page."
}
},
"required": [
"url"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"number",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"canonical": {
"type": [
"string",
"null"
]
},
"lang": {
"type": [
"string",
"null"
]
},
"favicon": {
"type": [
"string",
"null"
]
},
"apple_touch_icon": {},
"manifest": {},
"robots": {},
"opengraph": {
"type": [
"object",
"null"
],
"properties": {
"og:type": {
"type": [
"string",
"null"
]
},
"og:title": {
"type": [
"string",
"null"
]
},
"og:description": {
"type": [
"string",
"null"
]
},
"og:url": {
"type": [
"string",
"null"
]
},
"og:image": {
"type": [
"string",
"null"
]
}
}
},
"twitter": {
"type": [
"object",
"null"
],
"properties": {
"twitter:card": {
"type": [
"string",
"null"
]
},
"twitter:site": {
"type": [
"string",
"null"
]
},
"twitter:image": {
"type": [
"string",
"null"
]
}
}
},
"feeds": {
"type": "array"
},
"json_ld_types": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"h1": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"h2": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"link_preview_problems": {
"type": "array"
}
}
}🟢dns_lookup(domain)
All DNS for a domain — A, AAAA, CNAME, MX, NS, TXT, CAA, SOA — plus SPF and DMARC parsed and graded, so an agent knows where a domain points and whether its email can be spoofed. Queried live against public resolvers (Cloudflare, Google, Quad9). Email grade: SPF present and ending in -all/~all, DMARC present with p=quarantine/reject. When to use: For DNS records; for ownership dates use domain_whois; for certificates use tls_check. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "Domain name without scheme, e.g. \"example.com\"."
}
},
"required": [
"domain"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"domain": {
"type": [
"string",
"null"
]
},
"resolves": {
"type": [
"boolean",
"null"
]
},
"a": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"aaaa": {
"type": "array"
},
"cname": {
"type": "array"
},
"mx": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"exchange": {
"type": [
"string",
"null"
]
},
"priority": {
"type": [
"number",
"null"
]
}
}
}
},
"ns": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"txt": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"caa": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"critical": {
"type": [
"number",
"null"
]
},
"issue": {
"type": [
"string",
"null"
]
},
"issuewild": {
"type": [
"string",
"null"
]
}
}
}
},
"soa": {
"type": [
"object",
"null"
],
"properties": {
"nsname": {
"type": [
"string",
"null"
]
},
"hostmaster": {
"type": [
"string",
"null"
]
},
"serial": {
"type": [
"number",
"null"
]
},
"refresh": {
"type": [
"number",
"null"
]
},
"retry": {
"type": [
"number",
"null"
]
},
"expire": {
"type": [
"number",
"null"
]
},
"minttl": {
"type": [
"number",
"null"
]
}
}
},
"email_security": {
"type": [
"object",
"null"
],
"properties": {
"grade": {
"type": [
"string",
"null"
]
},
"spf": {
"type": [
"string",
"null"
]
},
"dmarc": {
"type": [
"string",
"null"
]
},
"dmarc_policy": {
"type": [
"string",
"null"
]
},
"issues": {
"type": "array"
}
}
}
}
}🟢domain_whois(domain)
Who registered a domain and when: registrar, creation/expiry dates, age, days to expiry, status locks, nameservers — or that it looks available to register. Uses RDAP, the registries' official successor to WHOIS (rdap.org bootstrap). A domain with no RDAP record and no DNS is reported as likely available. Young domains (< 30 days) are flagged: most phishing/scam sites are days old. When to use: For registration and expiry; for DNS records use dns_lookup. Price: $0.002 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "Registrable domain without scheme, e.g. \"example.com\"."
}
},
"required": [
"domain"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"domain": {
"type": [
"string",
"null"
]
},
"registered": {
"type": [
"boolean",
"null"
]
},
"registrar": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"iana_id": {
"type": [
"string",
"null"
]
}
}
},
"created": {
"type": [
"string",
"null"
]
},
"updated": {
"type": [
"string",
"null"
]
},
"expires": {
"type": [
"string",
"null"
]
},
"age_days": {
"type": [
"number",
"null"
]
},
"days_to_expiry": {
"type": [
"number",
"null"
]
},
"young_domain_warning": {
"type": [
"boolean",
"null"
]
},
"status": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"nameservers": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"dnssec": {
"type": [
"boolean",
"null"
]
},
"registrant": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"iana_id": {}
}
},
"source": {
"type": [
"string",
"null"
]
}
}
}🟢tls_check(host, port)
A site's TLS certificate: issuer, validity, days until expiry, SANs, protocol, cipher, chain and whether browsers trust it. Live TLS handshake to the host. Flags expired, expiring (< 14 days), untrusted or name-mismatched certificates. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"host": {
"type": "string",
"description": "Hostname without scheme or path, e.g. \"example.com\"."
},
"port": {
"type": "integer",
"minimum": 1,
"maximum": 65535,
"default": 443,
"description": "TCP port serving TLS. Range 1-65535. Default 443."
}
},
"required": [
"host"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"host": {
"type": [
"string",
"null"
]
},
"port": {
"type": [
"number",
"null"
]
},
"handshake_ms": {
"type": [
"number",
"null"
]
},
"protocol": {
"type": [
"string",
"null"
]
},
"cipher": {
"type": [
"string",
"null"
]
},
"alpn": {
"type": [
"string",
"null"
]
},
"trusted": {
"type": [
"boolean",
"null"
]
},
"trust_error": {},
"subject": {
"type": [
"string",
"null"
]
},
"issuer": {
"type": [
"string",
"null"
]
},
"issuer_cn": {
"type": [
"string",
"null"
]
},
"valid_from": {
"type": [
"string",
"null"
]
},
"valid_to": {
"type": [
"string",
"null"
]
},
"days_left": {
"type": [
"number",
"null"
]
},
"san": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"serial": {
"type": [
"string",
"null"
]
},
"fingerprint_sha256": {
"type": [
"string",
"null"
]
},
"key_bits": {
"type": [
"number",
"null"
]
},
"chain": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"subject": {
"type": [
"string",
"null"
]
},
"issuer": {
"type": [
"string",
"null"
]
},
"valid_to": {
"type": [
"string",
"null"
]
}
}
}
},
"warnings": {
"type": "array"
},
"ok": {
"type": [
"boolean",
"null"
]
}
}
}🟢http_probe(url)
Is a site up and how is it served: status, full redirect chain, timings (DNS/TLS/first byte/total), server, CDN, caching, compression, and a graded security-header check (HSTS, CSP, frame, sniffing…). One real GET from our server. The security grade counts HSTS, Content-Security-Policy, X-Frame-Options/frame-ancestors, X-Content-Type-Options, Referrer-Policy and Permissions-Policy. When to use: For availability, status and timings; for page content use web_read. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Absolute http(s) URL to probe."
}
},
"required": [
"url"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"final_url": {
"type": [
"string",
"null"
]
},
"up": {
"type": [
"boolean",
"null"
]
},
"status": {
"type": [
"number",
"null"
]
},
"redirects": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"status": {
"type": [
"number",
"null"
]
},
"ms": {
"type": [
"number",
"null"
]
}
}
}
},
"timing_ms": {
"type": [
"object",
"null"
],
"properties": {
"dns_connect": {
"type": [
"number",
"null"
]
},
"tls": {
"type": [
"number",
"null"
]
},
"first_byte": {
"type": [
"number",
"null"
]
},
"total": {
"type": [
"number",
"null"
]
}
}
},
"server": {
"type": [
"string",
"null"
]
},
"powered_by": {},
"cdn": {
"type": [
"string",
"null"
]
},
"remote_ip": {
"type": [
"string",
"null"
]
},
"content_type": {
"type": [
"string",
"null"
]
},
"bytes": {
"type": [
"number",
"null"
]
},
"compressed": {
"type": [
"boolean",
"null"
]
},
"cache_control": {},
"http_tls": {
"type": [
"object",
"null"
],
"properties": {
"protocol": {
"type": [
"string",
"null"
]
},
"cipher": {
"type": [
"string",
"null"
]
},
"authorized": {
"type": [
"boolean",
"null"
]
},
"subject": {
"type": [
"string",
"null"
]
},
"issuer": {
"type": [
"string",
"null"
]
},
"valid_to": {
"type": [
"string",
"null"
]
}
}
},
"security_headers": {
"type": [
"object",
"null"
],
"properties": {
"hsts": {
"type": [
"boolean",
"null"
]
},
"csp": {
"type": [
"boolean",
"null"
]
},
"frame_protection": {
"type": [
"boolean",
"null"
]
},
"nosniff": {
"type": [
"boolean",
"null"
]
},
"referrer_policy": {
"type": [
"boolean",
"null"
]
},
"permissions_policy": {
"type": [
"boolean",
"null"
]
},
"grade": {
"type": [
"string",
"null"
]
}
}
}
}
}🟢robots_check(url, user_agent)
May I crawl this? Checks a URL against the site's robots.txt for any user-agent, lists sitemaps and crawl-delay, and reports which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended…) the site blocks. Standard robots.txt matching (longest match wins, Allow beats Disallow on ties, * and $ wildcards). Missing robots.txt = everything allowed. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Absolute URL you intend to crawl."
},
"user_agent": {
"type": "string",
"default": "MAD-Synapse",
"description": "User-agent token to evaluate the rules for. Default \"MAD-Synapse\"."
}
},
"required": [
"url"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
]
},
"robots_txt": {
"type": [
"string",
"null"
]
},
"user_agent": {
"type": [
"string",
"null"
]
},
"path": {
"type": [
"string",
"null"
]
},
"allowed": {
"type": [
"boolean",
"null"
]
},
"matched_group": {
"type": [
"string",
"null"
]
},
"rule": {
"type": [
"string",
"null"
]
},
"crawl_delay": {},
"sitemaps": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"ai_crawlers_site_root": {
"type": [
"object",
"null"
],
"properties": {
"GPTBot": {
"type": [
"string",
"null"
]
},
"ChatGPT-User": {
"type": [
"string",
"null"
]
},
"OAI-SearchBot": {
"type": [
"string",
"null"
]
},
"ClaudeBot": {
"type": [
"string",
"null"
]
},
"Claude-User": {
"type": [
"string",
"null"
]
},
"Claude-SearchBot": {
"type": [
"string",
"null"
]
},
"anthropic-ai": {
"type": [
"string",
"null"
]
},
"Google-Extended": {
"type": [
"string",
"null"
]
},
"PerplexityBot": {
"type": [
"string",
"null"
]
},
"Perplexity-User": {
"type": [
"string",
"null"
]
},
"CCBot": {
"type": [
"string",
"null"
]
},
"Bytespider": {
"type": [
"string",
"null"
]
},
"Applebot-Extended": {
"type": [
"string",
"null"
]
},
"Meta-ExternalAgent": {
"type": [
"string",
"null"
]
},
"Amazonbot": {
"type": [
"string",
"null"
]
},
"cohere-ai": {
"type": [
"string",
"null"
]
},
"Diffbot": {
"type": [
"string",
"null"
]
},
"DuckAssistBot": {
"type": [
"string",
"null"
]
},
"MistralAI-User": {
"type": [
"string",
"null"
]
}
}
},
"groups": {
"type": [
"number",
"null"
]
}
}
}🟢email_check(email)
Will this email address work? Syntax, domain MX records, disposable/throwaway provider detection, role address (info@, admin@) and free-mail provider — without sending anything. No SMTP probing (that gets servers blacklisted); the verdict is from syntax, live MX lookup and a maintained list of ~100k disposable domains. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Email address to check. No mail is sent."
}
},
"required": [
"email"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"email": {
"type": [
"string",
"null"
]
},
"valid_syntax": {
"type": [
"boolean",
"null"
]
},
"domain": {
"type": [
"string",
"null"
]
},
"mx": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"exchange": {
"type": [
"string",
"null"
]
},
"priority": {
"type": [
"number",
"null"
]
}
}
}
},
"accepts_mail": {
"type": [
"boolean",
"null"
]
},
"disposable": {
"type": [
"boolean",
"null"
]
},
"role_address": {
"type": [
"boolean",
"null"
]
},
"free_provider": {
"type": [
"boolean",
"null"
]
},
"verdict": {
"type": [
"string",
"null"
]
}
}
}🟢wiki(query, lang, full, max_chars)
Wikipedia in any language: search a topic and get the best article's summary, description, thumbnail and link — or the full article text. Search + REST summary from Wikipedia. full=true returns the article as plain text (sections kept), capped by max_chars. Disambiguation pages are flagged with alternatives. When to use: For encyclopedic topics; for papers use arxiv_search or doi_lookup. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Topic or article title to look up."
},
"lang": {
"type": "string",
"pattern": "^[a-z]{2,3}(-[a-z]+)?$",
"default": "en",
"description": "Wikipedia language code, e.g. \"en\", \"de\", \"pt-br\". Default \"en\"."
},
"full": {
"type": "boolean",
"default": false,
"description": "true = return the full article text, not just the summary. Default false."
},
"max_chars": {
"type": "integer",
"minimum": 500,
"maximum": 60000,
"default": 8000,
"description": "Truncate full article text to this many characters (with full=true). Range 500-60000. Default 8000."
}
},
"required": [
"query"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": [
"boolean",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"description": {},
"summary": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"thumbnail": {
"type": [
"string",
"null"
]
},
"last_edited": {
"type": [
"string",
"null"
]
},
"other_matches": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"snippet": {
"type": [
"string",
"null"
]
}
}
}
}
}
}🟢arxiv_search(query, sort, limit)
Search arXiv research papers by keywords, author or category — newest or most relevant — with abstracts, authors, dates and PDF links. arXiv's official API. query supports arXiv syntax (ti:, au:, abs:, cat:cs.AI, AND/OR). Paced to arXiv's one-request-per-3-seconds policy and cached, so repeated queries are instant. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "e.g. \"tool use agents\" or au:hinton or cat:cs.CL AND ti:reasoning"
},
"sort": {
"type": "string",
"enum": [
"relevance",
"newest"
],
"default": "relevance",
"description": "Order by relevance to the query or by submission date. One of \"relevance\", \"newest\". Default \"relevance\"."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"default": 10,
"description": "How many papers to return. Range 1-30. Default 10."
}
},
"required": [
"query"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"query": {
"type": [
"string",
"null"
]
},
"total_results": {
"type": [
"number",
"null"
]
},
"papers": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"authors": {
"type": "array"
},
"published": {
"type": [
"string",
"null"
]
},
"updated": {
"type": [
"string",
"null"
]
},
"categories": {
"type": "array"
},
"abstract": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"pdf": {
"type": [
"string",
"null"
]
}
}
}
}
}
}🟢package_info(name, ecosystem)
Any npm, PyPI or crates.io package: latest version and release date, license, downloads, maintainers, repo, dependency count, deprecation — to pick or vet a dependency. Straight from each registry (plus npm and pypistats download counts). Flags deprecated packages and ones with no release in 2+ years. When to use: For package metadata; for known vulnerabilities in a version use vuln_check (on the MAD Synapse · Wallets & Risk server, https://agent.maddegen.art/hub/mcp/risk). Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Exact package name as published, e.g. \"express\" or \"requests\"."
},
"ecosystem": {
"type": "string",
"enum": [
"npm",
"pypi",
"crates"
],
"default": "npm",
"description": "Registry to look in. One of \"npm\", \"pypi\", \"crates\". Default \"npm\"."
}
},
"required": [
"name"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ecosystem": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"latest": {
"type": [
"string",
"null"
]
},
"released": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"deprecated": {},
"weekly_downloads": {
"type": [
"number",
"null"
]
},
"versions": {
"type": [
"number",
"null"
]
},
"dependencies": {
"type": [
"number",
"null"
]
},
"repository": {
"type": [
"string",
"null"
]
},
"homepage": {
"type": [
"string",
"null"
]
},
"maintainers": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"stale": {},
"url": {
"type": [
"string",
"null"
]
}
}
}🟢github_repo(repo)
A GitHub repository at a glance: stars, forks, open issues, last commit, latest release, license, languages, contributors, archived — is it alive and trustworthy? From the GitHub REST API. "activity" summarizes days since last push and last release so an agent can judge whether a project is maintained. Price: $0.002 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"repo": {
"type": "string",
"description": "owner/name or a github.com URL"
}
},
"required": [
"repo"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"repo": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"homepage": {
"type": [
"string",
"null"
]
},
"stars": {
"type": [
"number",
"null"
]
},
"forks": {
"type": [
"number",
"null"
]
},
"watchers": {
"type": [
"number",
"null"
]
},
"open_issues_and_prs": {
"type": [
"number",
"null"
]
},
"default_branch": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"topics": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"archived": {
"type": [
"boolean",
"null"
]
},
"is_fork": {
"type": [
"boolean",
"null"
]
},
"parent": {},
"created": {
"type": [
"string",
"null"
]
},
"last_push": {
"type": [
"string",
"null"
]
},
"latest_release": {
"type": [
"object",
"null"
],
"properties": {
"tag": {
"type": [
"string",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"prerelease": {
"type": [
"boolean",
"null"
]
}
}
},
"languages_pct": {
"type": [
"object",
"null"
],
"properties": {
"TypeScript": {
"type": [
"number",
"null"
]
},
"JavaScript": {
"type": [
"number",
"null"
]
},
"Just": {
"type": [
"number",
"null"
]
},
"Shell": {
"type": [
"number",
"null"
]
},
"CSS": {
"type": [
"number",
"null"
]
}
}
},
"top_contributors": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"login": {
"type": [
"string",
"null"
]
},
"commits": {
"type": [
"number",
"null"
]
}
}
}
},
"activity": {
"type": [
"object",
"null"
],
"properties": {
"days_since_push": {
"type": [
"number",
"null"
]
},
"days_since_release": {
"type": [
"number",
"null"
]
},
"verdict": {
"type": [
"string",
"null"
]
}
}
}
}
}🟢hn_search(query, type, sort, days, min_points, ...)
Search Hacker News stories and comments by keyword, sorted by relevance or date, filtered by time window and minimum points — what developers are saying about anything. Algolia's official HN search. Returns title, url, points, comment count, author, date and the HN discussion link. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keywords to search for."
},
"type": {
"type": "string",
"enum": [
"story",
"comment",
"show_hn",
"ask_hn"
],
"default": "story",
"description": "Stories, comments, Show HN or Ask HN posts. One of \"story\", \"comment\", \"show_hn\", \"ask_hn\". Default \"story\"."
},
"sort": {
"type": "string",
"enum": [
"relevance",
"date"
],
"default": "relevance",
"description": "Order by relevance or newest first. One of \"relevance\", \"date\". Default \"relevance\"."
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 3650,
"default": 365,
"description": "Only items from the last N days. Range 1-3650. Default 365."
},
"min_points": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Only items with at least this many points. Default 0."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 15,
"description": "How many results to return. Range 1-50. Default 15."
}
},
"required": [
"query"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"query": {
"type": [
"string",
"null"
]
},
"total": {
"type": [
"number",
"null"
]
},
"results": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"text": {
"type": [
"string",
"null"
]
},
"points": {
"type": [
"number",
"null"
]
},
"comments": {
"type": [
"number",
"null"
]
},
"author": {
"type": [
"string",
"null"
]
},
"date": {
"type": [
"string",
"null"
]
},
"hn": {
"type": [
"string",
"null"
]
}
}
}
}
}
}🟢doi_lookup(doi, query, limit)
Resolve a DOI — or search a paper title — to full citation metadata: title, authors, journal, year, citations count, publisher, license, and a ready-made APA/BibTeX citation. Crossref's open metadata (150M+ works). Search mode returns the top matches for a title/author query. When to use: For citation metadata of a known paper; to search preprints by topic use arxiv_search. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"doi": {
"type": "string",
"description": "e.g. 10.1038/nature14539"
},
"query": {
"type": "string",
"description": "title/author search instead of a DOI"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 5,
"description": "How many matches to return when searching by title. Range 1-20. Default 5."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": [
"boolean",
"null"
]
},
"doi": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"authors": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"year": {
"type": [
"number",
"null"
]
},
"journal": {
"type": [
"string",
"null"
]
},
"publisher": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"volume": {
"type": [
"string",
"null"
]
},
"issue": {
"type": [
"string",
"null"
]
},
"pages": {
"type": [
"string",
"null"
]
},
"cited_by": {
"type": [
"number",
"null"
]
},
"references": {
"type": [
"number",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"apa": {
"type": [
"string",
"null"
]
},
"bibtex": {
"type": [
"string",
"null"
]
}
}
}🟢book_search(query, limit)
Find books by title, author, subject or ISBN: first published year, editions, ISBNs, page count, ratings, subjects and cover image. Open Library (Internet Archive) catalogue of 30M+ titles. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "title, author or ISBN"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 5,
"description": "How many books to return. Range 1-20. Default 5."
}
},
"required": [
"query"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"total": {
"type": [
"number",
"null"
]
},
"books": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"title": {
"type": [
"string",
"null"
]
},
"authors": {
"type": "array"
},
"first_published": {
"type": [
"number",
"null"
]
},
"editions": {
"type": [
"number",
"null"
]
},
"pages_median": {
"type": [
"number",
"null"
]
},
"rating": {
"type": [
"number",
"null"
]
},
"ratings": {
"type": [
"number",
"null"
]
},
"isbn": {
"type": "array"
},
"publishers": {
"type": "array"
},
"languages": {
"type": "array"
},
"subjects": {
"type": "array"
},
"cover": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
}
}
}
}
}Community
Evidence