Skip to main content
Glama
firstcall-demo-mcp-server

firstcall-demo-mcp-server

by rad1092

FirstCall API Lookup

A read-only MCP server generated from a verified FirstCall recipe. It exposes one tool, github_user_lookup, which looks up public user records by username using the GitHub public API.

This repository is built from FirstCall, a local-first verified API recipe workbench for turning request sources into redacted agent-ready API tool packages.

Capabilities

  • Generated TypeScript MCP server artifact from FirstCall.

  • inputSchema, outputSchema, structuredContent, and MCP tool annotations.

  • Environment-variable-only secret handling. This server does not require secrets.

  • Read-only public API call to https://api.github.com/users/${username}.

Related MCP server: GitHub Read MCP Server

Tool

  • Tool name: github_user_lookup

  • Method: GET

  • URL template: https://api.github.com/users/${username}

  • Required input: username

  • Required secrets: none

Run Locally

npm install
npm run build
npm start

MCP Client Config

For clients that can run a GitHub-hosted npm package through npx:

{
  "mcpServers": {
    "firstcall-api-lookup": {
      "command": "npx",
      "args": ["-y", "github:rad1092/firstcall-api-lookup-mcp"]
    }
  }
}

For a local checkout:

{
  "mcpServers": {
    "firstcall-api-lookup": {
      "command": "node",
      "args": ["/absolute/path/to/firstcall-api-lookup-mcp/dist/server.js"]
    }
  }
}

Build the local checkout before using the second config:

npm install
npm run build

Docker

docker build -t firstcall-api-lookup-mcp .
docker run --rm -i firstcall-api-lookup-mcp

Generated By FirstCall

This server is generated from a verified FirstCall recipe. The generated MCP server is an artifact, not the source of truth for FirstCall package import. FirstCall keeps verification, packaging, validation, inspection, and local re-verification as explicit steps.

Safety Notes

  • No real tokens or secrets are committed here.

  • This server does not require environment variables.

  • Response previews are redacted by the generated server for common secret-looking keys.

  • The tool is read-only and carries MCP annotations as advisory hints.

  • Policy and local verification remain FirstCall's guardrails; MCP annotations are not security controls.

Available Tools

1 tool
github_user_lookupgithub_user_lookupC
Read-onlyIdempotent

Verified API tool recipes for AI agents.

Inputs: username (required). Returns: status, ok, body_preview

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.3/5.0

    Scored across 1 tool

    Disambiguation4/5

    Only one tool exists, so there is no risk of confusion between tools. However, the vague description 'Verified API tool recipes for AI agents' does not clearly distinguish its purpose.

    Naming Consistency3/5

    With a single tool, naming consistency is not a significant issue, but the name 'github_user_lookup' uses a noun-heavy pattern that is not a standard verb_noun convention.

    Tool Count2/5

    A single tool for a server named 'firstcall-demo-mcp-server' suggests an extremely narrow scope, likely insufficient for meaningful interaction without additional tools.

    Completeness2/5

    The single tool only covers user lookup, which is a minimal subset of potential GitHub operations. Obvious gaps like repository or issue management exist, making the surface incomplete.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP (Model Context Protocol) server for GitHub API integration. This server provides comprehensive tools for interacting with GitHub repositories, issues, pull requests, branches, and code search through a unified interface.
      15
      7 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A read-only MCP server that exposes GitHub user profiles, repository info, and search via tools for AI assistants like Claude.
      -