Skip to main content
Glama

@kotoragk/hp-mcp

A sample MCP (Model Context Protocol) server that exposes the kotoragk HP (homepage) public API as read-only tools. It is intentionally small: a thin HTTP client that fetches the existing HP endpoints and returns the JSON to the model.

Use it as a reference for how to build and publish an MCP server in TypeScript.

Tools

Tool

Arguments

Description

get_news

page? (number)

News (お知らせ) list with count and categories

get_news_detail

newsnumber (number)

A single news article, with prev/next links

get_company

Company (会社情報) profile

Each tool calls ${HP_API_BASE_URL}/hp/... and returns the raw JSON.

Related MCP server: Google News13 MCP Server

Install into Claude Code

claude mcp add hp -- npx -y @kotoragk/hp-mcp

To point at a different backend (e.g. a local Django server), pass the env var:

claude mcp add hp -e HP_API_BASE_URL=http://127.0.0.1:8000 -- npx -y @kotoragk/hp-mcp

Env var

Default

Description

HP_API_BASE_URL

https://kotoragk.com

Base URL of the HP API (no trailing /hp)

Local development

npm install
npm run build      # compiles src/ -> dist/
npm start          # runs dist/index.js on stdio

The server speaks the MCP protocol over stdio, so running it directly just waits for a client. Use an MCP client (Claude Code, the MCP Inspector, etc.) to interact with it.

Publish

npm login
npm publish --access public
Install Server
A
license - permissive license
B
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to search, retrieve, and interact with HackerNews content including stories, comments, polls, and user information. Provides comprehensive access to all HackerNews API endpoints with 15 specialized tools for content discovery and analysis.
    15
    19
    5
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Provides tools to search and retrieve news across various categories including business, technology, science, and sports via the Google News API. It supports keyword searches, autocomplete suggestions, and region-specific news across multiple languages.
    11
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    Enables LLMs to search for news articles, get top headlines, and access comprehensive news data with advanced filtering options through AllNewsAPI.
    1

View all related MCP servers

Related MCP Connectors

  • Gateway between LLM agents and world data through eight tools and a bundled endpoint catalog.

  • News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

  • Web search, news, page retrieval, sitemaps, and trending topics through Search1API.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/keisukearai/hp_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server