niwashi-mcp

MCP server for Cisco ACI (APIC). It reads the fabric's own object model rather than a fixed list of endpoints, so an LLM agent can navigate all 15,452 ACI classes through five generic tools — with no hardcoded class knowledge.

uvx niwashi-mcp

No repository to clone, no schema bundle to download. The object model ships inside the niwaki dependency as an embedded catalogue.

Configure

Three variables, in a .env file or the environment:

APIC_HOST=10.0.0.1
APIC_USER=admin
APIC_PASSWORD=…

Optional: APIC_VERIFY_SSL (default false), MCP_PORT (default 8000), MCP_API_KEYS (comma-separated bearer tokens — unset means no authentication, and the server says so loudly at startup), NIWASHI_MCP_ENV_FILE (explicit path to the .env).

The five tools

Tool Purpose
search_classes find the exact ACI class name from a keyword
get_schema identifiers, containment, relations, properties of a class
query filtered class query against the APIC
get_by_dn fetch one object directly by DN
count count objects without transferring them

The intended order is search_classes → get_schema → query. Skipping the first two returns empty results silently, because the APIC answers 200 OK with an empty list for an unknown class or attribute — it does not error.

Documentation

Full documentation, architecture notes and deployment guides: https://github.com/k3l0-dev/niwashi-mcp

The repository also carries mcp/client/SKILL.md — the operating guide to give an LLM client alongside the server. It teaches the ACI object model, the mandatory tool order, and how to read a relation without concluding wrongly.

Requirements

Python ≥ 3.12. A reachable APIC and a read-only service account.

Licence

PolyForm Noncommercial 1.0.0 — free for personal, research and noncommercial use. Commercial deployment or integration requires a commercial licence: monark.aiops@pm.me.

Cisco, Cisco ACI and APIC are trademarks of Cisco Systems, Inc. niwashi-mcp is an independent project, not affiliated with or endorsed by Cisco Systems, Inc.

Project links

Data verified by PyPI on Aug 9, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.1.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for k3l0-dev from gravatar.com k3l0-dev

Credits

Author/Maintainer: Khalid El-Ouiali

GitHub Statistics

Data verified by PyPI on Aug 9, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Other/Proprietary License (PolyForm-Noncommercial-1.0.0)

Requires

Python >=3.12

Tags

aci apic cisco llm mcp network-automation niwaki

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

niwashi_mcp-2.1.0.tar.gz (464.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

niwashi_mcp-2.1.0-py3-none-any.whl (59.2 kB view details)

Uploaded Python 3

File details

Details for the file niwashi_mcp-2.1.0.tar.gz.

File metadata

  • Download URL: niwashi_mcp-2.1.0.tar.gz
  • Upload date:
  • Size: 464.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for niwashi_mcp-2.1.0.tar.gz
Algorithm Hash digest
SHA256 ecfa29f20e48c7d887c625af925ff5df512534e3aeea0592e8facf2ba1a36493
MD5 38b94df8405fc5a288e8ae4ed92af9a0
BLAKE2b-256 11f3a6a2db48a3b6eb2e41d68545c5947dfd7d5b767927a1455368cbe178a58e

See more details on using hashes here.

Provenance

The following attestation bundles were made for niwashi_mcp-2.1.0.tar.gz:

Publisher: release.yml on k3l0-dev/niwashi-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file niwashi_mcp-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: niwashi_mcp-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 59.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for niwashi_mcp-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 251cede226764b680859007946595477992f01be88bd7ed08e42e329425381b0
MD5 e65d3f59e661157e499127515883dbaf
BLAKE2b-256 b69cf368d5addfbab866d9b50d92b8958903a0091948fea16a88b83bf4426970

See more details on using hashes here.

Provenance

The following attestation bundles were made for niwashi_mcp-2.1.0-py3-none-any.whl:

Publisher: release.yml on k3l0-dev/niwashi-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page