Name: Insperity MCP Server
Author: lwanger

Insperity MCP project

Python package to interact with Insperity REST API.

For examples on how to use the package, see the examples folder. The simplest example is:

from dotenv import load_dotenv from insperity_rest_api import * my_client_code = 'your client code here' # Get access credentials (token_dict, client_id, legal_id) to call the API endpoints token_dict, client_id, legal_id = get_credentials(client_code=my_client_code, legal_name_substring=None) # Use the access credentials to call an API endpoint response = get_minimal_employee_list(token_dict=token_dict, client_id=client_id, legal_id=legal_id)

note: don't put your client code in the script like was done above! See the examples in the examples folder for how to use environment variables to store your client code.

The insperity_mcp package can be found on GitHub at:

https://github.com/lwanger/insperity_mcp

Documentation for the Insperity REST API endpoints:

http://insperity.myisolved.com/rest

TODO:

test Insperity REST API
- get check details (requires employee id)
- implement additional REST API endpoints
use FastMCP to build MCP server
add ability to get employee profile to MCP
make an example for NEST: get employees hired since last 120 day check, termed since last check, get email address and send email to employee
running locally:
- Goose?: https://block.github.io/goose/docs/goose-architecture/
- https://blog.craigers.rocks/mcp-ollama/
- or: https://github.com/Sanjaykrishnamurthy/mcp-ollama-integration
- or: https://thomas.trocha.com/blog/creating-a-world-time-mcp-server-and-agent-with-a-local-ollama-llm-llama3-1-latest-on-linux/
- or: https://github.com/rajeevchandra/mcp-client-server-example
- or: https://medium.com/@techofhp/simple-mcp-tools-demo-using-fastmcp-and-a-local-llm-d266b8a166bd
- or: https://medium.com/@smrati.katiyar/building-mcp-server-and-client-in-python-and-using-ollama-as-llm-provider-dd79fe3a2b16
https://github.com/open-webui/open-webui

python-dotenv is used to manage environment variables, including API credentials. Variables, such as API credentials, should be stored in a .env file. Dotenv will automatically load variables from a .env file, where they will be available as environment variables. Environment variables should be named as follows: